通过

wintrust.h) (WINTRUST_CATALOG_INFO 结构

  • 项目

调用 WinVerifyTrust 以验证 Microsoft 目录的成员时，将使用 WINTRUST_CATALOG_INFO 结构。

语法

typedef struct WINTRUST_CATALOG_INFO_ {
  DWORD         cbStruct;
  DWORD         dwCatalogVersion;
  LPCWSTR       pcwszCatalogFilePath;
  LPCWSTR       pcwszMemberTag;
  LPCWSTR       pcwszMemberFilePath;
  HANDLE        hMemberFile;
  BYTE          *pbCalculatedFileHash;
  DWORD         cbCalculatedFileHash;
  PCCTL_CONTEXT pcCatalogContext;
  HCATADMIN     hCatAdmin;
} WINTRUST_CATALOG_INFO, *PWINTRUST_CATALOG_INFO;

成员

cbStruct

此结构的大小（以字节为单位）。

dwCatalogVersion

可选。 目录版本号。

pcwszCatalogFilePath

包含要验证的成员的目录文件的完整路径和文件名。

pcwszMemberTag

要验证的成员文件的标记。

pcwszMemberFilePath

要验证的目录成员文件的完整路径和文件名。

hMemberFile

可选。 要验证的打开目录成员文件的句柄。 句柄必须是至少具有读取权限的文件。

pbCalculatedFileHash

可选。 包含要验证的文件的文件的计算哈希。

cbCalculatedFileHash

在 pbCalculatedFileHash 成员中传递的值的大小（以字节为单位）。 仅当传递计算的哈希时才使用 cbCalculatedFileHash。

pcCatalogContext

指向 CTL_CONTEXT 结构的指针，该结构表示要使用的目录上下文，而不是目录文件。

hCatAdmin

计算文件哈希时使用的目录管理员上下文的句柄。 此值只能对于 SHA1 文件哈希为零。Windows 8 和 Windows Server 2012： 开始支持此成员。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 wintrust.h