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 |
|
|
Library |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 1/2/2013
