Funzione CryptCATCDFEnumAttributesWithCDFTag

Articolo
06/13/2023

[La funzione CryptCATCDFEnumAttributesWithCDFTag è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione CryptCATCDFEnumAttributesWithCDFTag enumera gli attributi dei file membro nella sezione CatalogFiles di un file di definizione del catalogo (CDF). CryptCATCDFEnumAttributesWithCDFTag viene chiamato da MakeCat.

Nota

Questa funzione non ha alcun file di intestazione associato o una libreria di importazione. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mssign32.dll.

Sintassi

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parametri

pCDF [in]: Puntatore a una struttura CRYPTCATCDF .
pwszMemberTag [in]: Puntatore a una stringa con terminazione null che identifica il membro del file di catalogo.
pMember [in]: Puntatore a una struttura CRYPTCATMEMBER contenente le informazioni del membro.
pPrevAttr [in]: Puntatore a una struttura CRYPTCATATTRIBUTE per un attributo membro del file in CDF a cui fa riferimento pCDF.
pfnParseError [in]: Puntatore a una funzione definita dall'utente per gestire gli errori di analisi dei file.

Valore restituito

Al termine dell'operazione, questa funzione restituisce un puntatore a una struttura CRYPTCATATTRIBUTE . La funzione CryptCATCDFEnumAttributesWithCDFTag restituisce un puntatore NULL se ha esito negativo.

Commenti

In genere si chiama questa funzione in un ciclo per enumerare tutti gli attributi del membro del file di catalogo in un CDF. Prima di immettere il ciclo, impostare pPrevAttr su NULL. La funzione restituisce un puntatore al primo attributo. Impostare pPrevAttr sul valore restituito della funzione per le iterazioni successive del ciclo.

Esempio

Nell'esempio seguente viene illustrata la sequenza corretta di assegnazioni per il parametro pPrevAttr (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);

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
DLL	Wintrust.dll

Vedi anche

MakeCat
CRYPTCATATTRIBUTE
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary

Condividi tramite