Función PstGetCertificates (certpoleng.h)

Recupera cadenas de certificados que especifican certificados que se pueden usar para autenticar a un usuario en el servidor especificado.

Sintaxis

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

Nombre del servidor que se va a comprobar.

[in] cCriteria

Número de elementos de la matriz rgpCriteria .

[in, optional] rgpCriteria

Puntero constante a una matriz de estructuras de CERT_SELECT_CRITERIA que especifican los criterios utilizados para seleccionar cadenas de certificados.

[in] bIsClient

TRUE si el autor de la llamada es el cliente; de lo contrario, FALSE.

[out] pdwCertChainContextCount

Número de elementos de la matriz ppCertChainContexts .

[out] ppCertChainContexts

Dirección de un puntero a una matriz de estructuras de CERT_CHAIN_CONTEXT que especifica las cadenas de certificados que se pueden usar para autenticar a un usuario en el servidor especificado por el parámetro pTargetName .

Valor devuelto

Si la función se realiza correctamente, devuelva STATUS_SUCCESS.

Si se produce un error en la función, devuelva un código NTSTATUS que indique el motivo por el que se produjo un error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certpoleng.h
Library	Certpoleng.lib
Archivo DLL	Certpoleng.dll