CryptCATCDFEnumMembersByCDFTagEx 函数

  • 项目

[ CryptCATCDFEnumMembersByCDFTagEx 函数可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]

CryptCATCDFEnumMembersByCDFTagEx 函数枚举目录定义文件的 CatalogFiles 部分中的各个文件成员 (CDF) 。 CryptCATCDFEnumMembersByCDFTagEx 由 MakeCat 调用。

注意

此函数没有关联的头文件或导入库。 若要调用此函数，必须创建用户定义的头文件，并使用 LoadLibrary 和 GetProcAddress 函数动态链接到Mssign32.dll。

 

语法

LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
  _In_    CRYPTCATCDF                  *pCDF,
  _Inout_ LPWSTR                       pwszPrevCDFTag,
  _In_    PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
  _In_    CRYPTCATMEMBER               **ppMember,
  _In_    BOOL                         fContinueOnError,
  _In_    LPVOID                       pvReserved
);

parameters

pCDF [in]

指向 CRYPTCATCDF 结构的指针。

pwszPrevCDFTag [in， out]

指向标识目录文件成员的 以 null 结尾的字符串的指针。

pfnParseError [in]

指向用于处理文件分析错误的用户定义的函数的指针。

ppMember [in]

指向包含文件成员信息的 CRYPTCATMEMBER 结构的指针。

fContinueOnError [in]

一个 值，该值指定是否在内存中保留对最后一个枚举成员的引用。

pvReserved [in]

此参数是保留的;请勿使用它。

返回值

成功后，此函数返回指向以 null 结尾的字符串的指针，该字符串标识 CDF 的 CatalogFiles 节中的文件成员。 CryptCATCDFEnumMembersByCDFTagEx 函数如果失败，则返回 NULL 指针。

备注

通常，在循环中调用此函数以枚举 CDF 中的所有目录文件成员。 在进入循环之前，请将 pwszPrevCDFTag 设置为 NULL。 函数返回指向第一个成员的指针。 为循环的后续迭代，将 pwszPrevCDFTag 设置为函数的返回值。

示例

以下示例演示 pwszPrevCDFTag 参数 () pwszMemberTag 的正确赋值序列。

    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L'myCDF', NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        //do something with pwszMemberTag and pMember
    }

    CryptCATCDFClose(pCDF);

要求

要求 值
最低受支持的客户端
 Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
DLL
Wintrust.dll

请参阅

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary