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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mscat.h |
| DLL | Wintrust.dll |