SSLCopyDistinguishedNames(_:_:)
Retrieves the distinguished names of acceptable certification authorities.
Declaration
func SSLCopyDistinguishedNames(_ context: SSLContext, _ names: UnsafeMutablePointer<CFArray?>) -> OSStatusParameters
- context:
An SSL session context reference.
- names:
On return, an array of
CFDataRefobjects, each representing one DER-encoded relative distinguished name of an acceptable certification authority. You must call theCFReleasefunction 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.