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

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

[in, optional] pwszWizardTitle

この関数が作成するダイアログ ボックスで使用するタイトルを含む、null で終わる Unicode 文字列へのポインター。 dwFlagsCRYPT_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