Share via

CTL_FIND_USAGE_PARA構造体 (wincrypt.h)

  • [アーティクル]

CTL_FIND_USAGE_PARA構造体は、CTL_FIND_SUBJECT_PARA構造体のメンバーであり、CertFindCTLInStore によって使用されます。

構文

typedef struct _CTL_FIND_USAGE_PARA {
  DWORD           cbSize;
  CTL_USAGE       SubjectUsage;
  CRYPT_DATA_BLOB ListIdentifier;
  PCERT_INFO      pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;

メンバー

cbSize

この構造体のサイズ (バイト単位)。

SubjectUsage

CTL_USAGE証明書信頼リスト (CTL) を検索するときに照合するオブジェクト識別子のシーケンスを含む構造体です。

見つかった CTL には、 SubjectUsage メンバーによって指定されたすべての使用状況オブジェクト識別子が含まれている必要があります。

この構造体の cUsageIdentifier メンバーが 0 の場合、任意の使用法を持つ CTL が一致する可能性があります。

ListIdentifier

特定の署名者 CTL リストへの検索を制限するために指定します。 通常、 ListIdentifier メンバーは 0 になり、 任意の ListIdentifier を 照合できることを示します。 0 でない場合、この ListIdentifier と CTL 内の ListIdentifier は一致する必要があります。

ListIdentifier を持たない CCTL のみを照合するには、ListIdentifier の cbData メンバーを CTL_FIND_NO_LIST_ID_CBDATA に設定します。

CTL では 、ListIdentifier を使用して、同じ SubjectUsage を持つ同じ発行者によって作成された複数の CCTL を区別します。

pSigner

照合する CTL 署名者を指定する CERT_INFO 構造体へのポインター。 署名者との照合には、 CERT_INFO の発行者とシリアル番号のみが使用されます。

任意の署名者と一致するように pSigner を NULL に設定します。 署名者を持たない CCTL と一致させるには、 pSigner を CTL_FIND_NO_SIGNER_PTR に設定します。

署名者の CertEncodingType は、CertFindCTLInStore の dwMsgAndCertEncodingType パラメーターから取得されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header wincrypt.h

こちらもご覧ください

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore