CryptCATCDFEnumMembersByCDFTagEx-Funktion
[Die Funktion CryptCATCDFEnumMembersByCDFTagEx 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 Funktion CryptCATCDFEnumMembersByCDFTagEx listet die einzelnen Dateimember im Abschnitt CatalogFiles einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumMembersByCDFTagEx 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
LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
_In_ CRYPTCATCDF *pCDF,
_Inout_ LPWSTR pwszPrevCDFTag,
_In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
_In_ CRYPTCATMEMBER **ppMember,
_In_ BOOL fContinueOnError,
_In_ LPVOID pvReserved
);
Parameter
-
pCDF [in]
-
Ein Zeiger auf eine CRYPTCATCDF-Struktur .
-
pwszPrevCDFTag [in, out]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Katalogdateimember identifiziert.
-
pfnParseError [in]
-
Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.
-
ppMember [in]
-
Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die die Dateimemberinformationen enthält.
-
fContinueOnError [in]
-
Ein -Wert, der angibt, ob ein Verweis auf den letzten aufgezählten Member im Arbeitsspeicher beibehalten werden soll.
-
pvReserved [in]
-
Dieser Parameter ist reserviert. verwenden Sie es nicht.
Rückgabewert
Bei erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf eine NULL-endende Zeichenfolge zurück, die einen Dateimember im Abschnitt CatalogFiles eines CDF identifiziert. Die Funktion CryptCATCDFEnumMembersByCDFTagEx gibt einen NULL-Zeiger zurück, wenn ein Fehler auftritt.
Bemerkungen
In der Regel rufen Sie diese Funktion in einer Schleife auf, um alle Katalogdateimember in einem CDF aufzulisten. Legen Sie pwszPrevCDFTag vor dem Eintritt in die Schleife auf NULL fest. Die Funktion gibt einen Zeiger auf den ersten Member zurück. Legen Sie pwszPrevCDFTag 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 parameter pwszPrevCDFTag (pwszMemberTag).
CRYPTCATMEMBER *pMember;
LPWSTR pwszMemberTag;
CRYPTCATCDF *pCDF;
pCDF = CryptCATCDFOpen(L'myCDF', NULL);
pMember = NULL;
pwszMemberTag = NULL;
while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
pwszMemberTag,
NULL,
&pMember,
FALSE,
NULL))
{
//do something with pwszMemberTag and pMember
}
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