Funzione PstGetCertificates (certpoleng.h)

Recupera le catene di certificati che specificano i certificati che possono essere usati per autenticare un utente nel server specificato.

Sintassi

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

Parametri

[in] pTargetName

Nome del server da controllare.

[in] cCriteria

Numero di elementi nella matrice rgpCriteria .

[in, optional] rgpCriteria

Puntatore costante a una matrice di strutture CERT_SELECT_CRITERIA che specificano i criteri utilizzati per selezionare le catene di certificati.

[in] bIsClient

TRUE se il chiamante è il client; in caso contrario, FALSE.

[out] pdwCertChainContextCount

Numero di elementi nella matrice ppCertChainContexts .

[out] ppCertChainContexts

Indirizzo di un puntatore a una matrice di strutture CERT_CHAIN_CONTEXT che specifica le catene di certificati di certificati che possono essere usate per autenticare un utente nel server specificato dal parametro pTargetName .

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituire un codice NTSTATUS che indica il motivo per cui non è riuscito.

Requisiti