CryptCATCDFEnumMembersByCDFTagEx-Funktion

Artikel
06/13/2023

[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	Wintrust.dll

Siehe auch

MakeCat
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary

Freigeben über