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 将返回以下错误代码之一。
返回代码 | 说明 |
---|---|
|
一个或多个参数无效。 |
注解
此函数仅支持用于可移植可执行映像 (.exe) 、柜 (.cab) 映像和平面文件 (SIP) 的主题接口包 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | mssip.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |