Function

CMSDecoderCopySignerCert

Obtains the certificate of the specified signer of a CMS message.

Declaration

OSStatus CMSDecoderCopySignerCert(CMSDecoderRef cmsDecoder, size_t signerIndex, SecCertificateRef  _Nullable *signerCertOut);

Parameters

cmsDecoder

The CMSDecoder reference returned by the CMSDecoderCreate function.

signerIndex

A number indicating which signer’s email address to return. Signer index numbers start with 0. Use the CMSDecoderGetNumSigners function to determine the total number of signers for a message.

signerCertOut

On return, points to the certificate of the specified signer.

Return Value

A result code. See Security Framework Result Codes. Returns errSecParam if the CMS message was not signed or if signerIndex is greater than the number of signers of the message minus one (signerIndex > (numSigners – 1)).

Discussion

You cannot call this function until after you have called the CMSDecoderFinalizeMessage function.

See Also

Signature Verification

CMSDecoderSetSearchKeychain

Specifies the keychains to search for intermediate certificates to be used in verifying a signed message's signer certificates.

Deprecated
CMSDecoderGetNumSigners

Obtains the number of signers of a message.

CMSDecoderCopySignerEmailAddress

Obtains the email address of the specified signer of a CMS message.

CMSDecoderCopySignerStatus

Obtains the status of a CMS message's signature.

CMSSignerStatus

The constants that indicate the status of the signature and signer information in a signed message.