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.

SSLSetCertificate

Specifies this connection’s certificate or certificates.

SSLGetClientCertificateState

Retrieves the exchange status of the client certificate.

SSLCopyPeerTrust

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

SSLClientCertificateState

An enumeration of the states of client certificate exchange.

SSLSetOCSPResponse

Sets the OCSP response for the given SSL session.

SSLSetSessionTicketsEnabled

Enables or disables session ticket resumption.