PstGetCertificates 関数 (certpoleng.h)

指定したサーバーでユーザーの認証に使用できる証明書を指定する証明書チェーンを取得します。

構文

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

パラメーター

[in] pTargetName

チェックするサーバーの名前。

[in] cCriteria

rgpCriteria 配列内の要素の数。

[in, optional] rgpCriteria

証明書チェーンの選択に使用する条件を指定する CERT_SELECT_CRITERIA 構造体の配列への定数ポインター。

[in] bIsClient

呼び出し元がクライアントの場合は TRUE。それ以外の場合は FALSE。

[out] pdwCertChainContextCount

ppCertChainContexts 配列内の要素の数。

[out] ppCertChainContexts

pTargetName パラメーターで指定されたサーバーでユーザーを認証するために使用できる証明書の証明書チェーンを指定する、CERT_CHAIN_CONTEXT構造体の配列へのポインターのアドレス。

戻り値

関数が成功した場合は、 STATUS_SUCCESSを返します。

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。

要件