ISCrdEnr::getCAName method

The getCAName method retrieves the name of the specified certification authority (CA) for a given certificate template.

Syntax

HRESULT getCAName(
  [in]  DWORD     dwFlags,
  [in]  BSTR     bstrCertTemplateName,
  [out] BSTR *pbstrCAName
);

SCrdEnr.getCAName( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName, _
  ByRef pbstrCAName _
)

Parameters

dwFlags [in]

A value that determines whether the name refers to the CA name or the CA's machine name. If this value is SCARD_ENROLL_CA_MACHINE_NAME (defined as 0x01) then the name refers to the CA's machine name; otherwise the name refers to the CA name.

bstrCertTemplateName [in]

The name of the certificate template.

pbstrCAName [out]

A pointer to a string that returns the name of the CA.

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 CA.

Remarks

The default CA name is the first name in the available list of CAs.

Requirements

Requirement Value
Minimum supported client
None supported
Minimum supported server
Windows Server 2003 [desktop apps only]
DLL
Scrdenrl.dll
IID
IID_ISCrdEnr is defined as 753988a1-1357-436d-9cf5-f089bdd67d64

See also

ISCrdEnr

ISCrdEnr::enumCAName

ISCrdEnr::getCACount

ISCrdEnr::setCAName