ISCrdEnr::enumCAName method

The enumCAName method enumerates the name of the certification authorities (CAs) for a given certificate template name.

Syntax

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

SCrdEnr.enumCAName( _
  ByVal dwIndex, _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName, _
  ByRef pbstrCAName _
)

Parameters

dwIndex [in]

The zero-based index for the enumeration sequence.

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), 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.

Requirements

See also

ISCrdEnr

ISCrdEnr::getCACount

ISCrdEnr::getCAName

ISCrdEnr::setCAName