CryptCATCDFEnumAttributesWithCDFTag-Funktion

Artikel
06/13/2023

[Die CryptCATCDFEnumAttributesWithCDFTag-Funktion steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die Funktion CryptCATCDFEnumAttributesWithCDFTag listet die Attribute von Memberdateien im Abschnitt CatalogFiles einer Katalogdefinitionsdatei (CDF) auf. CryptCATCDFEnumAttributesWithCDFTag 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

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 NULL-beendete Zeichenfolge, die das Element der Katalogdatei 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 Dateimemberattribut im CDF, auf das von pCDF verwiesen wird.
pfnParseError [in]: Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.

Rückgabewert

Nach erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück. Die CryptCATCDFEnumAttributesWithCDFTag-Funktion gibt einen NULL-Zeiger zurück, wenn ein Fehler auftritt.

Bemerkungen

Sie rufen diese Funktion in der Regel in einer Schleife auf, um alle Attribute des Katalogdateimitglieds in einem CDF aufzulisten. Legen Sie pPrevAttr vor dem Einstieg 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 Reihenfolge der 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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
DLL	Wintrust.dll

Siehe auch

MakeCat
CRYPTCATATTRIBUTE
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary

Share via