Partilhar via


Função CryptCATCDFEnumAttributesWithCDFTag

[A função CryptCATCDFEnumAttributesWithCDFTag 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 CryptCATCDFEnumAttributesWithCDFTag enumera os atributos dos arquivos membro na seção CatalogFiles de um arquivo de definição de catálogo (CDF). CryptCATCDFEnumAttributesWithCDFTag é 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

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parâmetros

pCDF [in]

Um ponteiro para uma estrutura CRYPTCATCDF .

pwszMemberTag [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica o membro do arquivo de catálogo.

pMember [in]

Um ponteiro para uma estrutura CRYPTCATMEMBER que contém as informações de membro.

pPrevAttr [in]

Um ponteiro para uma estrutura CRYPTCATATTRIBUTE para um atributo de membro de arquivo no CDF apontado por pCDF.

pfnParseError [in]

Um ponteiro para uma função definida pelo usuário para tratar erros de análise de arquivo.

Valor retornado

Após o sucesso, essa função retorna um ponteiro para uma estrutura CRYPTCATATTRIBUTE . A função CryptCATCDFEnumAttributesWithCDFTag retornará um ponteiro NULL se falhar.

Comentários

Normalmente, você chama essa função em um loop para enumerar todos os atributos de membro do arquivo de catálogo em um CDF. Antes de inserir o loop, defina pPrevAttr como NULL. A função retorna um ponteiro para o primeiro atributo. Defina pPrevAttr 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 pPrevAttr (pAttr).

    CRYPTCATATTRIBUTE   *pAttr;
    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

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

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        pAttr = NULL;

        while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
                                                           pwszMemberTag,
                                                           pMember,
                                                           pAttr,
                                                           DisplayParseError))
        {
            //do something with pAttr
        }

    }

    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

CRYPTCATATTRIBUTE

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary