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
ERROR_INVALID_PARAMETER
 一或多個參數無效。

備註

此函式僅支持用於可攜式執行映像的 主體介面套件 (SIP) ， (.exe) 、封包 (.cab) 映像和一般檔案。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 mssip.h
程式庫 Crypt32.lib
Dll Crypt32.dll