WTHelperCertFindIssuerCertificate 関数

  • [アーティクル]

[ WTHelperCertFindIssuerCertificate 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

WTHelperCertFindIssuerCertificate 関数は、指定したサブジェクト証明書と一致する指定された証明書ストアから発行者証明書を検索します。

Note

この関数には、関連付けられたインポート ライブラリがありません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Wintrust.dllに動的にリンクする必要があります。

 

構文

PCCERT_CONTEXT WINAPI WTHelperCertFindIssuerCertificate(
  _In_      PCCERT_CONTEXT pChildContext,
  _In_      DWORD          chStores,
  _In_      HCERTSTORE     *pahStores,
  _In_      FILETIME       *psftVerifyAsOf,
  _In_      DWORD          dwEncoding,
  _Out_opt_ DWORD          *pdwConfidence,
  _Out_     DWORD          *dwError
);

パラメーター

pChildContext [in]

一致する発行者証明書を検索するサブジェクト証明書。

chStores [in]

pahStores 配列内の要素の数。

pahStores [in]

検索する証明書ストアの配列。

psftVerifyAsOf [in]

検証の時刻。

dwEncoding [in]

チェックする証明書のエンコードの種類を指定する DWORD 値。 可能なエンコードの種類の詳細については、「 証明書とメッセージ のエンコードの種類」を参照してください。

pdwConfidence [out, optional]

このパラメーターには、次の信頼値の 0 個以上のビットごとの組み合わせを指定できます。

値 説明
CERT_CONFIDENCE_SIG
0x10000000
 証明書の署名が有効です。
CERT_CONFIDENCE_TIME
0x01000000
 証明書発行者の時刻が有効です。
CERT_CONFIDENCE_TIMENEST
0x00100000
 証明書の時刻が有効です。
CERT_CONFIDENCE_AUTHIDEXT
0x00010000
 機関 ID 拡張機能が有効です。
CERT_CONFIDENCE_HYGIENE
0x00001000
 少なくとも、証明書と機関 ID 拡張機能の署名は有効です。
CERT_CONFIDENCE_HIGHEST
0x11111000
 他のすべての信頼値の組み合わせ。

 

dwError [out]

この証明書のエラー値を含む DWORD 変数へのポインター (該当する場合)。

戻り値

pChildContext パラメーターで指定されたサブジェクト証明書と一致する発行者証明書。

解説

一致する発行者証明書を正常に見つけるには、次の要件を満たす必要があります。

  • pChildContext パラメーターで指定されたサブジェクト証明書の署名は有効である必要があります。
  • pChildContext パラメーターの pCertInfo メンバーの rgExtension メンバーには、CERT_AUTHORITY_KEY_ID_INFO構造体が含まれている必要があります。 この構造体 の CertIssuer メンバーと CertSerialMember メンバーは、発行者証明書の対応するメンバーと大きく一致します。
  • psftVerifyAsOf パラメーターの値は、サブジェクト証明書の有効期間内である必要があります。
  • サブジェクト証明書の有効期間は、発行者証明書の有効期間内である必要があります。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
[DLL]
Wintrust.dll