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 にすることができます。

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。

要件

要件	値
サポートされている最小のクライアント	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