CryptSIPRetrieveSubjectGuidForCatalogFile 函式 (mssip.h)
CryptSIPRetrieveSubjectGuidForCatalogFile 函式會擷取與指定檔案相關聯的主旨 GUID。
語法
BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
[in] LPCWSTR FileName,
[in, optional] HANDLE hFileIn,
[out] GUID *pgSubject
);
參數
[in] FileName
檔案的名稱。 如果已設定 hFileIn 參數,則會忽略此參數中的值。
[in, optional] hFileIn
要檢查之檔案的句柄。 如果 FileName 參數為 NULL,此參數必須包含有效的句柄。
[out] pgSubject
識別主體的全域唯一標識碼。
傳回值
如果函式成功,則傳回值為 TRUE ;否則為 FALSE。
如果此函式傳回 FALSE,則可以呼叫 GetLastError 函式來取得其他錯誤資訊。 GetLastError 會傳回下列其中一個錯誤碼。
傳回碼 | Description |
---|---|
|
一或多個參數無效。 |
備註
此函式僅支持用於可攜式執行映像的 主體介面套件 (SIP) , (.exe) 、封包 (.cab) 映像和一般檔案。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mssip.h |
程式庫 | Crypt32.lib |
Dll | Crypt32.dll |