PstGetCertificates-Funktion (certpoleng.h)

Ruft Zertifikatketten ab, die Zertifikate angeben, die zum Authentifizieren eines Benutzers auf dem angegebenen Server verwendet werden können.

Syntax

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
);

Parameter

[in] pTargetName

Der Name des zu überprüfenden Servers.

[in] cCriteria

Die Anzahl der Elemente im rgpCriteria-Array .

[in, optional] rgpCriteria

Ein konstanter Zeiger auf ein Array von CERT_SELECT_CRITERIA Strukturen, die die Kriterien angeben, die zum Auswählen von Zertifikatketten verwendet werden.

[in] bIsClient

TRUE , wenn der Aufrufer der Client ist; andernfalls FALSE.

[out] pdwCertChainContextCount

Die Anzahl der Elemente im PpCertChainContexts-Array .

[out] ppCertChainContexts

Die Adresse eines Zeigers auf ein Array von CERT_CHAIN_CONTEXT Strukturen, das die Zertifikatketten von Zertifikaten angibt, die zum Authentifizieren eines Benutzers auf dem vom pTargetName-Parameter angegebenen Server verwendet werden können.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für einen Fehler angibt.

Anforderungen