Deprecated Secure Transport Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.5

SSLGetPeerCertificates

Retrieves a peer certificate. (Deprecated in Mac OS X v10.5.)

OSStatus SSLGetPeerCertificates (
   SSLContextRef context,
   CFArrayRef *certs
);

Parameters

context: An SSL session context reference.
certs: On return, a pointer to an array of values of type SecCertificateRef representing the peer certificate and the certificate chain used to validate it. The certificate at index 0 of the returned array is the peer certificate; the root certificate (or the closest certificate to it) is at the end of the returned array. The entire array is created by the Secure Transport library; you must release it when you are finished with it.

Return Value

A result code. See “Secure Transport Result Codes.”

Discussion

This function is valid any time after a handshake attempt. You can use it to examine a peer certificate, to examine a certificate chain to determine why a handshake attempt failed, or to retrieve the certificate chain in order to validate the certificate yourself (see SSLSetEnableCertVerify).

Availability

Available in Mac OS X v10.2 and later.
Deprecated in Mac OS X v10.5.

Related Sample Code

SSLSample

Declared In

SecureTransport.h

SSLGetTrustedRoots

Retrieves the current list of trusted root certificates. (Deprecated in Mac OS X v10.5.)

OSStatus SSLGetTrustedRoots (
   SSLContextRef context,
   CFArrayRef *trustedRoots
);