CryptCATCDFEnumCatAttributes-Funktion (mscat.h)

[Die CryptCATCDFEnumCatAttributes-Funktion steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CryptCATCDFEnumCatAttributes-Funktion listet Attribute auf Katalogebene im CatalogHeader-Abschnitt einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumCatAttributes wird von MakeCat aufgerufen.

Syntax

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

Parameter

[in] pCDF

Ein Zeiger auf eine CRYPTCATCDF-Struktur .

[in] pPrevAttr

Ein Zeiger auf eine CRYPTCATATTRIBUTE-Struktur für ein Katalogattribut im CDF, auf das von pCDF verwiesen wird.

[in] pfnParseError

Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück. Die CryptCATCDFEnumCatAttributes-Funktion gibt einen NULL-Zeiger zurück, wenn ein Fehler auftritt.

Hinweise

In der Regel rufen Sie diese Funktion in einer Schleife auf, um alle Katalogheaderattribute in einem CDF aufzulisten. Legen Sie pPrevAttr vor dem Eintritt in die Schleife auf NULL fest. Die Funktion gibt einen Zeiger auf das erste Attribut zurück. Legen Sie pPrevAttr für nachfolgende Iterationen der Schleife auf den Rückgabewert der Funktion fest.

Beispiele

Das folgende Beispiel zeigt die richtige Reihenfolge der Zuweisungen für den pPrevAttr-Parameter (pAttr).

    CRYPTCATCDF         *pCDF;
    CRYPTCATATTRIBUTE   *pAttr;

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

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

    CryptCATCDFClose(pCDF);

Anforderungen

Weitere Informationen

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat