CTL_VERIFY_USAGE_STATUS 構造体 (wincrypt.h)
CTL_VERIFY_USAGE_STATUS構造体には、CertVerifyCTLUsage によって返される証明書信頼リスト (CTL) に関する情報が含まれています。
構文
typedef struct _CTL_VERIFY_USAGE_STATUS {
DWORD cbSize;
DWORD dwError;
DWORD dwFlags;
PCCTL_CONTEXT *ppCtl;
DWORD dwCtlEntryIndex;
PCCERT_CONTEXT *ppSigner;
DWORD dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;
メンバー
cbSize
構造体のサイズ (バイト単位)。 CertVerifyCTLUsage を呼び出すアプリケーションは、このパラメーターを設定します。 cbSize が構造体の必要なサイズ以上でない場合、CertVerifyCTLUsage は FALSE を返し、GetLastError はE_INVALIDARGを返します。
dwError
CertVerifyCTLUsage の呼び出しによって返されるエラー状態 (ある場合)。 考えられるエラー値の一覧については、 CertVerifyCTLUsage の「戻り値」セクションを参照してください。
dwFlags
CERT_VERIFY_UPDATED_CTL_FLAGが返された場合、CertVerifyCTLUsage は、時間が有効でなくなった CTL を、新しい時間有効な CTL で更新しました。
ppCtl
一致したサブジェクトを含む CTL コンテキスト へのポインターへのポインター。 呼び出し元のアプリケーションは、サブジェクトを含む CTL が返されないことを示すために、このポインターを NULL に設定できます。
ppCtl が NULL でない場合、呼び出し元のアプリケーションは CertFreeCTLContext を使用して返されたコンテキストを解放する必要があります。
dwCtlEntryIndex
CTL の配列内の一致するサブジェクトのエントリの配列位置を返します。
ppSigner
CTL の署名者の証明書コンテキストへのポインターへのポインター。 このポインターは、CTL の署名者の証明書が返されないことを示す呼び出し元のアプリケーションによって NULL に設定できます。
ppSigner が NULL でない場合、呼び出し元のアプリケーションは CertFreeCTLContext を使用して返されたコンテキストを解放する必要があります。
dwSignerIndex
実際に使用される署名者のインデックス。 メッセージに複数の署名者が含まれた場合に必要です。
注釈
メンバー dwError、 dwFlags、 dwCtlEntryIndex、 および dwSignerIndex は、呼び出し元のアプリケーションによって 0 に初期化する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | wincrypt.h |