PstMapCertificate function (certpoleng.h)

Retrieves a structure that specifies information that can be used to create a user token associated with the specified certificate.

Syntax

NTSTATUS PstMapCertificate(
  [in]  PCCERT_CONTEXT             pCert,
  [out] LSA_TOKEN_INFORMATION_TYPE *pTokenInformationType,
  [out] PVOID                      *ppTokenInformation
);

Parameters

[in] pCert

A constant pointer to a CERT_CONTEXT structure that specifies the certificate for which to obtain token information.

[out] pTokenInformationType

A pointer to a value of the LSA_TOKEN_INFORMATION_TYPE enumeration that indicates the type of structure pointed to by the ppTokenInformation parameter.

[out] ppTokenInformation

The address of a pointer to a structure that specifies information that can be used to create a user token.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header certpoleng.h
Library Certpoleng.lib
DLL Certpoleng.dll