Função CryptCATCDFEnumMembersByCDFTagEx
[A função CryptCATCDFEnumMembersByCDFTagEx está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
A função CryptCATCDFEnumMembersByCDFTagEx enumera os membros de arquivo individuais na seção CatalogFiles de um arquivo de definição de catálogo (CDF). CryptCATCDFEnumMembersByCDFTagEx é chamado por MakeCat.
Observação
Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mssign32.dll.
Sintaxe
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
);
Parâmetros
-
pCDF [in]
-
Um ponteiro para uma estrutura CRYPTCATCDF .
-
pwszPrevCDFTag [in, out]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica o membro do arquivo de catálogo.
-
pfnParseError [in]
-
Um ponteiro para uma função definida pelo usuário para lidar com erros de análise de arquivo.
-
ppMember [in]
-
Um ponteiro para uma estrutura CRYPTCATMEMBER que contém as informações do membro do arquivo.
-
fContinueOnError [in]
-
Um valor que especifica se deve manter na memória uma referência ao último membro enumerado.
-
pvReserved [in]
-
Esse parâmetro é reservado; não o use.
Valor retornado
Após o sucesso, essa função retorna um ponteiro para uma cadeia de caracteres terminada em nulo que identifica um membro de arquivo na seção CatalogFiles de um CDF. A função CryptCATCDFEnumMembersByCDFTagEx retornará um ponteiro NULL se falhar.
Comentários
Normalmente, você chama essa função em um loop para enumerar todos os membros do arquivo de catálogo em um CDF. Antes de inserir o loop, defina pwszPrevCDFTag como NULL. A função retorna um ponteiro para o primeiro membro. Defina pwszPrevCDFTag como o valor retornado da função para iterações subsequentes do loop.
Exemplos
O exemplo a seguir mostra a sequência correta de atribuições para o parâmetro 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);
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| DLL |
|
Confira também