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
| Requirement | Value |
|---|---|
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| DLL |
|
| IID |
IID_ISCrdEnr is defined as 753988a1-1357-436d-9cf5-f089bdd67d64 |
See also