CryptCATCDFEnumAttributesWithCDFTag-Funktion

[Die Funktion CryptCATCDFEnumAttributesWithCDFTag steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Es kann in nachfolgenden Versionen geändert oder entfernt werden.]

Die CryptCATCDFEnumAttributesWithCDFTag-Funktion führt die Attribute von Memberdateien im Abschnitt CatalogFiles einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumAttributesWithCDFTag wird von MakeCat aufgerufen.

Hinweis

Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Zum Aufrufen dieser Funktion müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Mssign32.dll.

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 mit NULL beendete Zeichenfolge, die das Katalogdateimitglied 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 Dateimitgliedsattribut in der CDF, auf das pCDF zeigt.

pfnParseError [ In]

Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateiparsenfehlern.

Rückgabewert

Bei Erfolg gibt diese Funktion einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück. Die CryptCATCDFEnumAttributesWithCDFTag-Funktion gibt bei einem Fehler einen NULL-Zeiger zurück.

Hinweise

In der Regel rufen Sie diese Funktion in einer Schleife auf, um alle Memberattribute der Katalogdatei in einer CDF aufzählen. Legen Sie pPrevAttr vor dem Eintritt 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 Sequenz von 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 Nur [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
Wintrust.dll

Weitere Informationen

MakeCat

CRYPTCATATTRIBUTE

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary