CryptCATCDFEnumCatAttributes-Funktion (mscat.h)

[Die CryptCATCDFEnumCatAttributes-Funktion ist für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen verfügbar. 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
);

Die 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 pCDF verweist.

[in] pfnParseError

Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.

Rückgabewert

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

Bemerkungen

In der Regel rufen Sie diese Funktion in einer Schleife auf, um alle Katalogheaderattribute in einem CDF aufzählen zu können. Legen Sie vor dem Eingeben der Schleife "pPrevAttr " auf NULL fest. Die Funktion gibt einen Zeiger auf das erste Attribut zurück. Legen Sie pPrevAttr auf den Rückgabewert der Funktion für nachfolgende Iterationen der Schleife fest.

Examples

Das folgende Beispiel zeigt die richtige Abfolge von Zuordnungen 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

Anforderung	Wert
Mindestens unterstützter Client	Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	mscat.h
Library	nanosrv.lib
DLL	Wintrust.dll

Siehe auch

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat