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 |
|
请参阅