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

Siehe auch

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary