Função PstGetCertificates (certpoleng.h)

Recupera cadeias de certificados que especificam certificados que podem ser usados para autenticar um usuário no servidor especificado.

Sintaxe

NTSTATUS PstGetCertificates(
  [in]           PUNICODE_STRING        pTargetName,
  [in]           DWORD                  cCriteria,
  [in, optional] PCCERT_SELECT_CRITERIA rgpCriteria,
  [in]           BOOL                   bIsClient,
  [out]          PDWORD                 pdwCertChainContextCount,
  [out]          PCCERT_CHAIN_CONTEXT   **ppCertChainContexts
);

Parâmetros

[in] pTargetName

O nome do servidor a ser marcar.

[in] cCriteria

O número de elementos na matriz rgpCriteria .

[in, optional] rgpCriteria

Um ponteiro constante para uma matriz de estruturas de CERT_SELECT_CRITERIA que especificam os critérios usados para selecionar cadeias de certificados.

[in] bIsClient

TRUE se o chamador for o cliente; caso contrário, FALSE.

[out] pdwCertChainContextCount

O número de elementos na matriz ppCertChainContexts .

[out] ppCertChainContexts

O endereço de um ponteiro para uma matriz de estruturas CERT_CHAIN_CONTEXT que especifica as cadeias de certificados de certificados que podem ser usados para autenticar um usuário no servidor especificado pelo parâmetro pTargetName .

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certpoleng.h
Biblioteca	Certpoleng.lib
DLL	Certpoleng.dll