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	Wintrust.dll

Confira também

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary