CryptCATCDFEnumAttributesWithCDFTag-Funktion
[Die CryptCATCDFEnumAttributesWithCDFTag-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 Funktion CryptCATCDFEnumAttributesWithCDFTag listet die Attribute von Memberdateien im Abschnitt CatalogFiles einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumAttributesWithCDFTag wird von MakeCat aufgerufen.
Hinweis
Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mssign32.dll verwenden.
Syntax
CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
_In_ CRYPTCATCDF *pCDF,
_In_ LPWSTR pwszMemberTag,
_In_ CRYPTCATMEMBER *pMember,
_In_ CRYPTCATATTRIBUTE *pPrevAttr,
_In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
Parameter
-
pCDF [in]
-
Ein Zeiger auf eine CRYPTCATCDF-Struktur .
-
pwszMemberTag [in]
-
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die das Element der Katalogdatei identifiziert.
-
pMember [in]
-
Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die die Memberinformationen enthält.
-
pPrevAttr [in]
-
Ein Zeiger auf eine CRYPTCATATTRIBUTE-Struktur für ein Dateimemberattribut im CDF, auf das von pCDF verwiesen wird.
-
pfnParseError [in]
-
Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.
Rückgabewert
Nach erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück. Die CryptCATCDFEnumAttributesWithCDFTag-Funktion gibt einen NULL-Zeiger zurück, wenn ein Fehler auftritt.
Bemerkungen
Sie rufen diese Funktion in der Regel in einer Schleife auf, um alle Attribute des Katalogdateimitglieds in einem CDF aufzulisten. Legen Sie pPrevAttr vor dem Einstieg in die Schleife 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.
Beispiele
Das folgende Beispiel zeigt die richtige Reihenfolge der Zuweisungen für den pPrevAttr-Parameter (pAttr).
CRYPTCATATTRIBUTE *pAttr;
CRYPTCATMEMBER *pMember;
LPWSTR pwszMemberTag;
CRYPTCATCDF *pCDF;
pCDF = CryptCATCDFOpen(L"myCDF", NULL);
pMember = NULL;
pwszMemberTag = NULL;
while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
pwszMemberTag,
NULL,
&pMember,
FALSE,
NULL))
{
pAttr = NULL;
while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
pwszMemberTag,
pMember,
pAttr,
DisplayParseError))
{
//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] |
| DLL |
|
Siehe auch