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 por pCDF.

[in] pfnParseError

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

Retornar valor

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

Comentários

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);

Requisitos

Confira também

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat