WINTRUST_DATA結構 (wintrust.h)
[ 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) 。 這個成員必須是下列其中一個值。
值 | 意義 |
---|---|
|
顯示所有UI。 |
|
不顯示任何UI。 |
|
不顯示任何負面UI。 |
|
不顯示任何正面UI。 |
fdwRevocationChecks
憑證撤銷檢查選項。 這個成員可以設定為將撤銷檢查新增至所選原則提供者所完成的撤銷檢查。 這個成員必須是下列其中一個值。
值 | 意義 |
---|---|
|
當WTD_REVOKE_NONE旗標與 WinVerifyTrust 函式的 pgActionID 參數中所設定的HTTPSPROV_ACTION值搭配使用時,將不會執行額外的撤銷檢查。 為了確保 WinVerifyTrust 函式不會在驗證程式代碼簽章時嘗試任何網路擷取, WTD_CACHE_ONLY_URL_RETRIEVAL 必須在 dwProvFlags 參數中設定。 |
|
撤銷檢查會在整個鏈結上完成。 |
dwUnionChoice
指定要使用的等位成員,因此,將會驗證信任的物件類型。 這個成員必須是下列其中一個值。
值 | 意義 |
---|---|
|
使用 pFile 所指向的檔案。 |
|
使用 pCatalog 指向的目錄。 |
|
使用 pBlob 指向的 BLOB。 |
|
使用 [WINTRUST_SGNR_INFO] (/windows/desktop/api/wintrust/ns-wintrust-wintrust_sgnr_info) 結構, pSgnr 所指向。 |
|
使用 pCert 所指向的憑證。 |
pFile
WINTRUST_FILE_INFO 結構的指標。
pCatalog
WINTRUST_CATALOG_INFO 結構的指標。
pBlob
WINTRUST_BLOB_INFO 結構的指標。
pSgnr
WINTRUST_SGNR_INFO 結構的指標。
pCert
WINTRUST_CERT_INFO 結構的指標。
pDetachedSig
dwStateAction
指定要採取的動作。 這可以是下列其中一個值。
hWVTStateData
狀態數據的句柄。 此成員的內容取決於 dwStateAction 成員的值。
pwszURLReference
保留供未來使用。 設定為 NULL。
dwProvFlags
指定信任提供者設定的 DWORD 值。 這可以是零個或多個下列值的位元組合。
值 | 意義 |
---|---|
|
信任的驗證方式與 Internet Explorer 4.0 實作的方式相同。 |
|
不會使用 Internet Explorer 4.0 鏈結功能。 |
|
不會執行原則提供者的默認驗證,例如 Authenticode 的程式代碼簽署,而且會假設憑證適用於所有使用方式。 |
|
不會執行撤銷檢查。 |
|
撤銷檢查只會在結束憑證上執行。 |
|
撤銷檢查會在整個憑證鏈結上執行。 |
|
撤銷檢查會在整個憑證鏈結上執行,不包括跟證書。 |
|
不支援。 |
|
只會驗證哈希。 |
|
系統會執行預設作業系統版本檢查。 此旗標僅用於驗證目錄簽署的檔案。 |
|
如果未設定此旗標,所有時間戳簽章都會視為永久有效。 設定此旗標會將簽章的有效存留期限制為簽署憑證的存留期。 這可讓時間戳簽章過期。 |
|
僅使用本機快取進行撤銷檢查。 防止透過網路撤銷檢查。
Windowsxp: 不支援此值。 |
|
停用 MD2 和 MD4 哈希演算法的使用。 如果使用 MD2 或 MD4 簽署檔案,而且已設定此旗標,則會傳回NTE_BAD_ALGID錯誤。
注意 Windows 7 支援 SP1 和更新版本的作業系統旗標。
|
|
如果指定此旗標,則會假設已從 Web 下載正在驗證的檔案,且具有 Web 屬性的 Mark。 將強制執行要套用至 Web 檔案標記的原則。
注意Windows 8.1 和更新版本的操作系統或已安裝KB2862966的系統上,都支援此旗標。
|
dwUIContext
DWORD 值,指定 WinVerifyTrust 函式的使用者介面內容。 這會導致 [Authenticode] 對話框中的文字符合檔案上所採取的動作。 這可以是下列其中一個值。
值 | 意義 |
---|---|
|
針對要執行的檔案呼叫 WinVerifyTrust 時, 請使用 。 這是預設值。 |
|
針對要安裝的檔案呼叫 WinVerifyTrust 時, 請使用 。 |
pSignatureSettings
WINTRUST_SIGNATURE_SETTINGS 結構的指標。
Windows 8 和 Windows Server 2012:開始支援此成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | wintrust.h |