CryptCATCDFEnumMembersByCDFTagEx-Funktion
[Die CryptCATCDFEnumMembersByCDFTagEx-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden.]
Die CryptCATCDFEnumMembersByCDFTagEx-Funktion listet die einzelnen Dateimember im Abschnitt CatalogFiles einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumMembersByCDFTagEx wird von MakeCataufgerufen.
Hinweis
Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch eine Verknüpfung mit Mssign32.dll herzustellen.
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 auf NULL endende Zeichenfolge, die den Katalogdateimember identifiziert.
-
pfnParseError [ In]
-
Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateiparsfehlern.
-
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 aufzählten Member im Arbeitsspeicher beibehalten werden soll.
-
pvReserved [ In]
-
Dieser Parameter ist reserviert. nicht verwenden.
Rückgabewert
Bei Erfolg gibt diese Funktion einen Zeiger auf eine mit NULL endende Zeichenfolge zurück, die einen Dateimember im CatalogFiles-Abschnitt einer CDF identifiziert. Die CryptCATCDFEnumMembersByCDFTagEx-Funktion gibt bei einem Fehler einen NULL-Zeiger zurück.
Hinweise
Sie rufen diese Funktion in der Regel in einer Schleife auf, um alle Katalogdateimember in einer CDF aufzulisten. Legen Sie vor dem Eintritt in die Schleife pwszPrevCDFTag 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 Sequenz von Zuweisungen für den pwszPrevCDFTag-Parameter ( 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 [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|