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

标识主题的全局唯一 ID。

返回值

如果函数成功,则返回值为 TRUE ;否则为 FALSE

如果此函数返回 FALSE,可以通过调用 GetLastError 函数来获取其他错误信息。 GetLastError 将返回以下错误代码之一。

返回代码 说明
ERROR_INVALID_PARAMETER
一个或多个参数无效。

注解

此函数仅支持用于可移植可执行映像 (.exe) 、柜 (.cab) 映像和平面文件 (SIP) 的主题接口包

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 mssip.h
Library Crypt32.lib
DLL Crypt32.dll