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
 透過 Internet Explorer 驗證 SSL/PCT 連線。

[in] fdwFlags

值，判斷此函式是否報告登錄錯誤。 如果 fdwFlags 為零，而且此函式遇到登錄錯誤，則登錄錯誤不會傳播至 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
程式庫 Wintrust.lib
Dll Wintrust.dll

另請參閱

WintrustRemoveActionID