CRYPTUI_WIZ_DIGITAL_SIGN_INFO 構造体 (cryptuiapi.h)

[ CRYPTUI_WIZ_DIGITAL_SIGN_INFO 構造は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

CRYPTUI_WIZ_DIGITAL_SIGN_INFO構造には、デジタル署名に関する情報が含まれています。 この構造体は、 CryptUIWizDigitalSign 関数によって使用されます。

構文

typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO {
  DWORD                                    dwSize;
  DWORD                                    dwSubjectChoice;
  union {
    LPCWSTR                              pwszFileName;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
  };
  DWORD                                    dwSigningCertChoice;
  union {
    PCCERT_CONTEXT                           pSigningCertContext;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO    pSigningCertStore;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
  };
  LPCWSTR                                  pwszTimestampURL;
  DWORD                                    dwAdditionalCertChoice;
  PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
} CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;

メンバー

dwSize

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

dwSubjectChoice

署名するエンティティを示す 値。 このメンバーは、CryptUIWizDigitalSign 関数の dwFlags パラメーターでCRYPTUI_WIZ_NO_UIが指定されている場合に必要です。 これには、次のいずれかの値を指定できます。

意味
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
pSignBlobInfo メンバーによって指定されたメモリ BLOB に署名します。
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
pwszFileName メンバーによって指定されたファイルは署名されます。
0
ユーザーは、署名するファイルの入力を求められます。

pwszFileName

署名するファイルのパスとファイル名を含む null で終わる Unicode 文字列へのポインター。 このメンバーは、dwSubjectChoice メンバーにCRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILEが指定されている場合に使用されます。

pSignBlobInfo

署名する BLOB を含む CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO 構造体へのポインター。 このメンバーは、dwSubjectChoice メンバーにCRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOBが指定されている場合に使用されます。

dwSigningCertChoice

エンティティの署名に使用される証明書の場所を示す 値。 既定値はゼロです。 これには、次のいずれかの値を指定できます。

メモCryptUIWizDigitalSign 関数の dwFlags パラメーターにCRYPTUI_WIZ_NO_UIが指定されている場合、この値はCRYPTUI_WIZ_DIGITAL_SIGN_CERTまたはCRYPTUI_WIZ_DIGITAL_SIGN_PVKである必要があります。
 
意味
CRYPTUI_WIZ_DIGITAL_SIGN_CERT
証明書は、pSigningCertContext メンバーが指すCERT_CONTEXT構造に含まれています。
CRYPTUI_WIZ_DIGITAL_SIGN_STORE
証明書は、pSigningCertStore メンバーが指すCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO構造に含まれる証明書ストアに含まれています。
CRYPTUI_WIZ_DIGITAL_SIGN_PVK
証明書は、pSigningCertPvkInfo メンバーが指すCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO構造に含まれる PVK ファイルに含まれています。
0
マイ ストアの証明書が使用されます。

pSigningCertContext

エンティティの署名に使用する証明書を含むCERT_CONTEXT構造体へのポインター。 このメンバーは、dwSigningCertChoice メンバーにCRYPTUI_WIZ_DIGITAL_SIGN_CERTが指定されている場合に使用されます。

pSigningCertStore

エンティティの署名に使用する証明書を含む CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO 構造体へのポインター。 このメンバーは、dwSigningCertChoice メンバーにCRYPTUI_WIZ_DIGITAL_SIGN_STOREが指定されている場合に使用されます。

pSigningCertPvkInfo

エンティティの署名に使用する証明書を含む CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO 構造体へのポインター。 このメンバーは、dwSigningCertChoice メンバーにCRYPTUI_WIZ_DIGITAL_SIGN_PVKが指定されている場合に使用されます。

pwszTimestampURL

タイム スタンプの URL を含む null で終わる Unicode 文字列へのポインター。

dwAdditionalCertChoice

追加の証明書を署名に含めるかどうかを示す 値。 既定値はゼロです。 これには、次のいずれかの値を指定できます。

意味
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN
証明書チェーン全体が署名に含まれます。
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT
ルートを除く証明書チェーン内のすべての証明書が署名に含まれます。
0
署名には追加の証明書は含まれません。

pSignExtInfo

署名に関する拡張情報を含む CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO 構造体へのポインター。

要件

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

こちらもご覧ください

CryptUIWizDigitalSign