PstGetCertificates, fonction (certpoleng.h)

Récupère les chaînes de certificats qui spécifient les certificats qui peuvent être utilisés pour authentifier un utilisateur sur le serveur spécifié.

Syntaxe

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

Paramètres

[in] pTargetName

Nom du serveur à case activée.

[in] cCriteria

Nombre d’éléments dans le tableau rgpCriteria .

[in, optional] rgpCriteria

Pointeur constant vers un tableau de structures CERT_SELECT_CRITERIA qui spécifient les critères utilisés pour sélectionner des chaînes de certificats.

[in] bIsClient

TRUE si l’appelant est le client ; sinon, FALSE.

[out] pdwCertChainContextCount

Nombre d’éléments dans le tableau ppCertChainContexts .

[out] ppCertChainContexts

Adresse d’un pointeur vers un tableau de structures CERT_CHAIN_CONTEXT qui spécifie les chaînes de certificats qui peuvent être utilisées pour authentifier un utilisateur sur le serveur spécifié par le paramètre pTargetName .

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retournez un code NTSTATUS qui indique la raison de son échec.

Configuration requise