CryptUIWizDigitalSign 関数 (cryptuiapi.h)

  • [アーティクル]

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

CryptUIWizDigitalSign 関数は、ドキュメントまたは BLOB にデジタル署名します。 ドキュメントまたは BLOB は、ユーザー操作の有無にかかわらず署名できます。

構文

BOOL CryptUIWizDigitalSign(
  [in]            DWORD                              dwFlags,
  [in, optional]  HWND                               hwndParent,
  [in, optional]  LPCWSTR                            pwszWizardTitle,
  [in]            PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO    pDigitalSignInfo,
  [out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);

パラメーター

[in] dwFlags

関数の動作を変更するフラグが含まれています。 0 または次の値を指定できます。

値 意味
CRYPTUI_WIZ_NO_UI
0x0001
 この関数は、ユーザー インターフェイスを表示せずに、pDigitalSignInfo パラメーターが指すCRYPTUI_WIZ_DIGITAL_SIGN_INFO構造体の情報に基づいてドキュメントに署名します。 このフラグを指定しない場合、この関数は、署名プロセスをユーザーに案内するウィザードを表示します。

[in, optional] hwndParent

この関数が作成するダイアログ ボックスの親として使用するウィンドウのハンドル。 dwFlags でCRYPTUI_WIZ_NO_UI フラグが設定されている場合、このパラメーターは無視されます。

[in, optional] pwszWizardTitle

この関数が作成するダイアログ ボックスで使用するタイトルを含む、null で終わる Unicode 文字列へのポインター。 dwFlags でCRYPT_WIZ_NO_UI フラグが設定されている場合、このパラメーターは無視されます。 このパラメーターが NULL の場合は、既定のタイトルが使用されます。

[in] pDigitalSignInfo

署名プロセスに関する情報を含む CRYPTUI_WIZ_DIGITAL_SIGN_INFO 構造体へのポインター。

[out, optional] ppSignContext

署名付き BLOB を受け取る CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT 構造体ポインターへのポインター。 この構造体の使用が完了したら、このポインターを CryptUIWizFreeDigitalSignContext 関数に渡してメモリを解放する必要があります。 署名済み BLOB が必要ない場合は、このパラメーターを NULL にすることができます 。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー cryptuiapi.h
Library Cryptui.lib
[DLL] Cryptui.dll

こちらもご覧ください

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext