WINTRUST_DATA結構 (wintrust.h)

發行項
03/04/2024

[ WINTRUST_DATA 結構可用於需求一節中指定的操作系統。它可能會在後續版本中改變或無法使用。]

呼叫 WinVerifyTrust 以將必要資訊傳遞至信任提供者時，會使用WINTRUST_DATA結構。

語法

typedef struct _WINTRUST_DATA {
  DWORD                               cbStruct;
  LPVOID                              pPolicyCallbackData;
  LPVOID                              pSIPClientData;
  DWORD                               dwUIChoice;
  DWORD                               fdwRevocationChecks;
  DWORD                               dwUnionChoice;
  union {
#if ...
    WINTRUST_FILE_INFO_                *pFile;
#else
    struct WINTRUST_FILE_INFO_         *pFile;
#endif
#if ...
    WINTRUST_CATALOG_INFO_             *pCatalog;
#else
    struct WINTRUST_CATALOG_INFO_      *pCatalog;
#endif
#if ...
    WINTRUST_BLOB_INFO_                *pBlob;
#else
    struct WINTRUST_BLOB_INFO_         *pBlob;
#endif
#if ...
    WINTRUST_SGNR_INFO_                *pSgnr;
#else
    struct WINTRUST_SGNR_INFO_         *pSgnr;
#endif
#if ...
    WINTRUST_CERT_INFO_                *pCert;
#else
    struct WINTRUST_CERT_INFO_         *pCert;
#endif
#if ...
    WINTRUST_DETACHED_SIG_INFO_        *pDetachedSig;
#else
    struct WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#endif
  };
  DWORD                               dwStateAction;
  HANDLE                              hWVTStateData;
  WCHAR                               *pwszURLReference;
  DWORD                               dwProvFlags;
  DWORD                               dwUIContext;
  struct WINTRUST_SIGNATURE_SETTINGS_ *pSignatureSettings;
} WINTRUST_DATA, *PWINTRUST_DATA;

成員

cbStruct

這個結構的大小，以位元組為單位。

pPolicyCallbackData

用來將原則特定數據傳遞至原則提供者的數據緩衝區指標。這個成員可以是 NULL。

pSIPClientData

用來將主體介面套件 (SIP) 特定數據傳遞至 SIP 提供者的數據緩衝區指標。這個成員可以是 NULL。

dwUIChoice

指定要使用的使用者介面類型 (UI) 。這個成員必須是下列其中一個值。

值	意義
WTD_UI_ALL 1	顯示所有UI。
WTD_UI_NONE 2	不顯示任何UI。
WTD_UI_NOBAD 3	不顯示任何負面UI。
WTD_UI_NOGOOD 4	不顯示任何正面UI。

fdwRevocationChecks

憑證撤銷檢查選項。這個成員可以設定為將撤銷檢查新增至所選原則提供者所完成的撤銷檢查。這個成員必須是下列其中一個值。

值	意義
WTD_REVOKE_NONE 0	當WTD_REVOKE_NONE旗標與 WinVerifyTrust 函式的 pgActionID 參數中所設定的HTTPSPROV_ACTION值搭配使用時，將不會執行額外的撤銷檢查。為了確保 WinVerifyTrust 函式不會在驗證程式代碼簽章時嘗試任何網路擷取， WTD_CACHE_ONLY_URL_RETRIEVAL 必須在 dwProvFlags 參數中設定。
WTD_REVOKE_WHOLECHAIN 1	撤銷檢查會在整個鏈結上完成。

dwUnionChoice

指定要使用的等位成員，因此，將會驗證信任的物件類型。這個成員必須是下列其中一個值。

值	意義
WTD_CHOICE_FILE 1	使用 pFile 所指向的檔案。
WTD_CHOICE_CATALOG 2	使用 pCatalog 指向的目錄。
WTD_CHOICE_BLOB 3	使用 pBlob 指向的 BLOB。
WTD_CHOICE_SIGNER 4	使用 [WINTRUST_SGNR_INFO] (/windows/desktop/api/wintrust/ns-wintrust-wintrust_sgnr_info) 結構， pSgnr 所指向。
WTD_CHOICE_CERT 5	使用 pCert 所指向的憑證。

pFile

WINTRUST_FILE_INFO 結構的指標。

pCatalog

WINTRUST_CATALOG_INFO 結構的指標。

pBlob

WINTRUST_BLOB_INFO 結構的指標。

pSgnr

WINTRUST_SGNR_INFO 結構的指標。

pCert

WINTRUST_CERT_INFO 結構的指標。

pDetachedSig

dwStateAction

指定要採取的動作。這可以是下列其中一個值。

值	意義
WTD_STATEACTION_IGNORE 0x00000000	忽略 hWVTStateData 成員。
WTD_STATEACTION_VERIFY 0x00000001	確認物件的信任 (通常是由 dwUnionChoice 成員指定的檔案) 。 hWVTStateData 成員會收到狀態數據的句柄。在後續呼叫中指定 WTD_STATEACTION_CLOSE 動作，必須釋放此句柄。
WTD_STATEACTION_CLOSE 0x00000002	釋放先前使用 WTD_STATEACTION_VERIFY 動作配置的 hWVTStateData 成員。每次使用 WTD_STATEACTION_VERIFY 動作時，都必須指定此動作。
WTD_STATEACTION_AUTO_CACHE 0x00000003	將目錄數據寫入 WINTRUST_DATA 結構，然後快取該結構。只有當 dwUnionChoice 成員包含 WTD_CHOICE_CATALOG時，才會套用此動作。
WTD_STATEACTION_AUTO_CACHE_FLUSH 0x00000004	排清任何快取的目錄數據。只有當 dwUnionChoice 成員包含 WTD_CHOICE_CATALOG時，才會套用此動作。

hWVTStateData

狀態數據的句柄。此成員的內容取決於 dwStateAction 成員的值。

pwszURLReference

保留供未來使用。設定為 NULL。

dwProvFlags

指定信任提供者設定的 DWORD 值。這可以是零個或多個下列值的位元組合。

值	意義
WTD_USE_IE4_TRUST_FLAG 1 (0x1)	信任的驗證方式與 Internet Explorer 4.0 實作的方式相同。
WTD_NO_IE4_CHAIN_FLAG 2 (0x2)	不會使用 Internet Explorer 4.0 鏈結功能。
WTD_NO_POLICY_USAGE_FLAG 4 (0x4)	不會執行原則提供者的默認驗證，例如 Authenticode 的程式代碼簽署，而且會假設憑證適用於所有使用方式。
WTD_REVOCATION_CHECK_NONE 16 (0x10)	不會執行撤銷檢查。
WTD_REVOCATION_CHECK_END_CERT 32 (0x20)	撤銷檢查只會在結束憑證上執行。
WTD_REVOCATION_CHECK_CHAIN 64 (0x40)	撤銷檢查會在整個憑證鏈結上執行。
WTD_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT 128 (0x80)	撤銷檢查會在整個憑證鏈結上執行，不包括跟證書。
WTD_SAFER_FLAG 256 (0x100)	不支援。
WTD_HASH_ONLY_FLAG 512 (0x200)	只會驗證哈希。
WTD_USE_DEFAULT_OSVER_CHECK 1024 (0x400)	系統會執行預設作業系統版本檢查。此旗標僅用於驗證目錄簽署的檔案。
WTD_LIFETIME_SIGNING_FLAG 2048 (0x800)	如果未設定此旗標，所有時間戳簽章都會視為永久有效。設定此旗標會將簽章的有效存留期限制為簽署憑證的存留期。這可讓時間戳簽章過期。
WTD_CACHE_ONLY_URL_RETRIEVAL 4096 (0x1000)	僅使用本機快取進行撤銷檢查。防止透過網路撤銷檢查。 Windowsxp：不支援此值。
WTD_DISABLE_MD2_MD4 8192 (0x2000)	停用 MD2 和 MD4 哈希演算法的使用。如果使用 MD2 或 MD4 簽署檔案，而且已設定此旗標，則會傳回NTE_BAD_ALGID錯誤。注意 Windows 7 支援 SP1 和更新版本的作業系統旗標。
WTD_MOTW 16384 (0x4000)	如果指定此旗標，則會假設已從 Web 下載正在驗證的檔案，且具有 Web 屬性的 Mark。將強制執行要套用至 Web 檔案標記的原則。注意Windows 8.1 和更新版本的操作系統或已安裝KB2862966的系統上，都支援此旗標。

dwUIContext

DWORD 值，指定 WinVerifyTrust 函式的使用者介面內容。這會導致 [Authenticode] 對話框中的文字符合檔案上所採取的動作。這可以是下列其中一個值。

值	意義
WTD_UICONTEXT_EXECUTE 0	針對要執行的檔案呼叫 WinVerifyTrust 時，請使用。這是預設值。
WTD_UICONTEXT_INSTALL 1	針對要安裝的檔案呼叫 WinVerifyTrust 時，請使用。

pSignatureSettings

WINTRUST_SIGNATURE_SETTINGS 結構的指標。

Windows 8 和 Windows Server 2012：開始支援此成員。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	wintrust.h

共用方式為

WINTRUST_DATA結構 (wintrust.h)

語法

成員

規格需求

意見反應

其他資源