WintrustAddActionID 関数 (wintrust.h)

[ WintrustAddActionID 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 証明書の検証には、 CertGetCertificateChain 関数と CertVerifyCertificateChainPolicy 関数を 使用します。 Microsoft Authenticode テクノロジ署名検証の場合は、.NET Frameworkを使用します。]

WintrustAddActionID 関数は、信頼プロバイダー アクションをユーザーのシステムに追加します。 このメソッドは、信頼プロバイダーの DllRegisterServer 実装中に呼び出す必要があります。 この関数には、インポート ライブラリが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Wintrust.dll に動的にリンクする必要があります。

このメソッドは、信頼プロバイダーによってのみ呼び出す必要があります。

構文

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

パラメーター

[in] pgActionID

追加するアクションとそのアクションをサポートする信頼プロバイダーを識別する GUID 構造体へのポインター。

WinTrust サービスは、サード パーティによって実装された信頼プロバイダーと連携するように設計されています。 各信頼プロバイダーは、独自の一意のアクション識別子のセットを提供します。 信頼プロバイダーでサポートされているアクション識別子の詳細については、その信頼プロバイダーのドキュメントを参照してください。

たとえば、Microsoft は、インターネットまたはその他のパブリック ネットワークからダウンロードされるソフトウェアの信頼性を確立できるソフトウェア 発行元信頼プロバイダーを提供します。 ソフトウェア 発行元信頼プロバイダーでは、次のアクション識別子がサポートされています。 これらの定数は Softpub.h で定義されています。

値	意味
WINTRUST_ACTION_GENERIC_VERIFY	証明書チェーンのみを確認します。
WINTRUST_ACTION_GENERIC_VERIFY_V2	Authenticode ポリシー プロバイダーを使用してファイルまたはオブジェクトを確認します。
HTTPSPROV_ACTION	インターネット エクスプローラー経由で SSL/PCT 接続を確認します。

[in] fdwFlags

レジストリ エラーがこの関数によって報告されるかどうかを決定する値。 fdwFlags が 0 で、この関数でレジストリ エラーが発生した場合、レジストリ エラーは GetLastError 関数に反映されません。 fdwFlags がWT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) であり、この関数でレジストリ エラーが発生した場合、レジストリ エラーは GetLastError 関数に反映されます。

[in] psProvInfo

信頼プロバイダーの情報を定義する CRYPT_REGISTER_ACTIONID 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は TRUE です。 関数 が失敗した場合は FALSE。 関数が失敗した場合は、 GetLastError 関数を呼び出して、エラーの理由を特定します。 この関数で発生する可能性があるレジストリ エラーの詳細については、 fdwFlags の説明を参照してください。

注釈

この関数によって追加されたアクションを削除するには、 WintrustRemoveActionID 関数を呼び出します。

要件

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

こちらもご覧ください

WintrustRemoveActionID