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 に初期化する必要があります。

要件

こちらもご覧ください

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage