ISCrdEnr::getSigningCertificateName method

The getSigningCertificateName method retrieves the subject name from the signing certificate.

This method can also be used to display the certificate in a dialog box. This method calls the CryptoAPI function CertGetNameString.

Syntax

HRESULT getSigningCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrSigningCertName
);

SCrdEnr.getSigningCertificateName( _
  ByVal dwFlags, _
  ByRef pbstrSigningCertName _
)

Parameters

dwFlags [in]

A value that determines whether the certificate is displayed in a dialog box. If this value is SCARD_ENROLL_NO_DISPLAY_CERT (defined as 0x01), the signing certificate is not displayed; any other values result in the signing certificate being displayed in the Certificate dialog box.

pbstrSigningCertName [out]

A pointer to a string that returns the name of the signing certificate. The signing certificate will be used to sign the certificate request.

Return value

C++

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

A string that represents the name of the signing certificate. The signing certificate will be used to sign the certificate request.

Remarks

The getSigningCertificateName method returns the subject name of the certificate you (or another administrator) have selected in a previous successful call to ISCrdEnr::selectSigningCertificate or ISCrdEnr::setSigningCertificate. This method calls the CertGetNameString function to retrieve the subject name according to the sequence described for the CERT_NAME_SIMPLE_DISPLAY_TYPE value of CertGetNameString's dwType parameter.

Requirements

See also

ISCrdEnr

ISCrdEnr::selectSigningCertificate