Funzione CryptCATCDFEnumCatAttributes (mscat.h)

[La funzione CryptCATCDFEnumCatAttributes è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

La funzione CryptCATCDFEnumCatAttributes enumera gli attributi a livello di catalogo all'interno della sezione CatalogHeader di un file di definizione del catalogo (CDF). CryptCATCDFEnumCatAttributes viene chiamato da MakeCat.

Sintassi

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

Parametri

[in] pCDF

Puntatore a una struttura CRYPTCATCDF .

[in] pPrevAttr

Puntatore a una struttura CRYPTCATATTRIBUTE per un attributo di catalogo in CDF a cui punta pCDF.

[in] pfnParseError

Puntatore a una funzione definita dall'utente per gestire gli errori di analisi dei file.

Valore restituito

Al termine dell'operazione, questa funzione restituisce un puntatore a una struttura CRYPTCATATTRIBUTE . La funzione CryptCATCDFEnumCatAttributes restituisce un puntatore NULL se ha esito negativo.

Commenti

Questa funzione viene in genere chiamata in un ciclo per enumerare tutti gli attributi dell'intestazione del catalogo in un file CDF. Prima di immettere il ciclo, impostare pPrevAttr su NULL. La funzione restituisce un puntatore al primo attributo. Impostare pPrevAttr sul valore restituito della funzione per le iterazioni successive del ciclo.

Esempio

Nell'esempio seguente viene illustrata la sequenza corretta di assegnazioni per il parametro 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);

Requisiti

Vedi anche

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat