PstGetCertificates function

Retrieves certificate chains that specify certificates that can be used to authenticate a user on the specified server.

Syntax


NTSTATUS WINAPI PstGetCertificates(
  _In_     PUNICODE_STRING        pTargetName,
  _In_     DWORD                  cCriteria,
  _In_opt_ PCCERT_SELECT_CRITERIA rgpCriteria,
  _In_     BOOL                   bIsClient,
  _Out_    PDWORD                 pdwCertChainContextCount,
  _Out_    PCCERT_CHAIN_CONTEXT   **ppCertChainContexts
);

Parameters

pTargetName [in]

The name of the server to check.

cCriteria [in]

The number of elements in the rgpCriteria array.

rgpCriteria [in, optional]

A constant pointer to an array of CERT_SELECT_CRITERIA structures that specify the criteria used to select certificate chains.

bIsClient [in]

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

pdwCertChainContextCount [out]

The number of elements in the ppCertChainContexts array.

ppCertChainContexts [out]

The address of a pointer to an array of CERT_CHAIN_CONTEXT structures that specifies the certificate chains of certificates that can be used to authenticate a user on the server specified by the pTargetName parameter.

Return value

If the function succeeds, return STATUS_SUCCESS.

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

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Certpoleng.h

Library

Certpoleng.lib

DLL

Certpoleng.dll

 

 

Show: