ISCrdEnr::getCertTemplateName method

The getCertTemplateName method retrieves the name of the certificate template.

Syntax

HRESULT getCertTemplateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrCertTemplateName
);

SCrdEnr.getCertTemplateName( _
  ByVal dwFlags, _
  ByRef pbstrCertTemplateName _
)

Parameters

dwFlags [in]

A value that determines whether the certificate template's real name or display name is returned. If dwFlags has the value SCARD_ENROLL_CERT_TEMPLATE_DISPLAY_NAME, the certificate template's display name is retrieved; otherwise, the real name of the certificate template is displayed.

pbstrCertTemplateName [out]

A pointer to a string that returns the name of the certificate template which will be used in 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 certificate template which will be used in the certificate request.

Remarks

If you do not set the certificate template name by calling ISCrdEnr::setCertTemplateName, the name defaults to the first name in the list of available certificate templates.

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::setCertTemplateName