Função CryptCATCDFEnumCatAttributes (mscat.h)

[A função CryptCATCDFEnumCatAttributes 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 CryptCATCDFEnumCatAttributes enumera atributos no nível do catálogo na seção CatalogHeader de um arquivo de definição de catálogo (CDF). CryptCATCDFEnumCatAttributes é chamado por MakeCat.

Sintaxe

CRYPTCATATTRIBUTE * CryptCATCDFEnumCatAttributes(
  [in] CRYPTCATCDF                  *pCDF,
  [in] CRYPTCATATTRIBUTE            *pPrevAttr,
  [in] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parâmetros

[in] pCDF

Um ponteiro para uma estrutura CRYPTCATCDF .

[in] pPrevAttr

Um ponteiro para uma estrutura CRYPTCATATTRIBUTE para um atributo de catálogo no CDF apontado pelo pCDF.

[in] pfnParseError

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

Valor de retorno

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

Observações

Normalmente, você chama essa função em um loop para enumerar todos os atributos de cabeçalho do 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).

    CRYPTCATCDF         *pCDF;
    CRYPTCATATTRIBUTE   *pAttr;

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

    while (pAttr = CryptCATCDFEnumCatAttributes(pCDF, pAttr, NULL))
    {
        //do something with pAttr
    }

    CryptCATCDFClose(pCDF);

Requirements

Consulte também

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat