Function

SSLCopyDistinguishedNames

Retrieves the distinguished names of acceptable certification authorities.

Declaration

OSStatus SSLCopyDistinguishedNames(SSLContextRef context, CFArrayRef  _Nullable *names);

Parameters

context

An SSL session context reference.

names

On return, an array of CFDataRef objects, each representing one DER-encoded relative distinguished name of an acceptable certification authority. You must call the CFRelease function to release this array when you are finished with it.

Return Value

A result code. See Secure Transport Result Codes.

Discussion

The list of distinguished names is provided by the server if the context reference represents a client; if the context reference represents a server, the list of distinguished names is specified with the SSLSetCertificateAuthorities function.

The array retrieved by this function is suitable for use in finding a client identity (that is, a certificate and associated private key) that matches a server's requirements.

See Also

Authentication

SSLAddDistinguishedName

Adds a DER-encoded distinguished name to a list of acceptable names to be specified in requests for client certificates.

Deprecated
SSLSetCertificate

Specifies this connection’s certificate or certificates.

Deprecated
SSLGetClientCertificateState

Retrieves the exchange status of the client certificate.

Deprecated
SSLCopyPeerTrust

Retrieves a trust management object for the certificate used by a session.

Deprecated
SSLClientCertificateState

An enumeration of the states of client certificate exchange.

SSLSetOCSPResponse

Sets the OCSP response for the given SSL session.

Deprecated
SSLSetSessionTicketsEnabled

Enables or disables session ticket resumption.

Deprecated