PstValidate function (certpoleng.h)

Validates the specified certificate.

Syntax

NTSTATUS PstValidate(
  [in, optional]  PUNICODE_STRING  pTargetName,
  [in]            BOOL             bIsClient,
  [in, optional]  CERT_USAGE_MATCH *pRequestedIssuancePolicy,
  [in, optional]  HCERTSTORE       *phAdditionalCertStore,
  [in]            PCCERT_CONTEXT   pCert,
  [out, optional] GUID             *pProvGUID
);

Parameters

[in, optional] pTargetName

The name of the server. If the caller is not the client, this parameter is NULL.

[in] bIsClient

TRUE if the caller is the client; otherwise, FALSE.

[in, optional] pRequestedIssuancePolicy

A pointer to a CERT_USAGE_MATCH structure that specifies identifiers that the certificate must match to be validated.

[in, optional] phAdditionalCertStore

A handle to a certificate store that contains additional certificates used for the authentication.

[in] pCert

A pointer to a CERT_CONTEXT structure that specifies the certificate to validate.

[out, optional] pProvGUID

A pointer to a GUID structure that receives the security support provider (SSP) used for the authentication.

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