Funzione CryptCATCDFEnumMembersByCDFTagEx

Articolo
06/13/2023

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

La funzione CryptCATCDFEnumMembersByCDFTagEx enumera i singoli membri di file nella sezione CatalogFiles di un file di definizione del catalogo (CDF). CryptCATCDFEnumMembersByCDFTagEx viene chiamato da MakeCat.

Nota

Questa funzione non ha un file di intestazione o una libreria di importazione associata. 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

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
);

Parametri

pCDF [in]: Puntatore a una struttura CRYPTCATCDF .
pwszPrevCDFTag [in, out]: Puntatore a una stringa con terminazione Null che identifica il membro del file di catalogo.
pfnParseError [in]: Puntatore a una funzione definita dall'utente per gestire gli errori di analisi dei file.
ppMember [in]: Puntatore a una struttura CRYPTCATMEMBER che contiene le informazioni sui membri del file.
fContinueOnError [in]: Valore che specifica se mantenere in memoria un riferimento all'ultimo membro enumerato.
pvReserved [in]: Questo parametro è riservato; non usarlo.

Valore restituito

Al termine dell'operazione, questa funzione restituisce un puntatore a una stringa con terminazione Null che identifica un membro del file nella sezione CatalogFiles di una funzione CDF. La funzione CryptCATCDFEnumMembersByCDFTagEx restituisce un puntatore NULL in caso di errore.

Commenti

Questa funzione viene in genere chiamata in un ciclo per enumerare tutti i membri del file di catalogo in un file CDF. Prima di immettere il ciclo, impostare pwszPrevCDFTag su NULL. La funzione restituisce un puntatore al primo membro. Impostare pwszPrevCDFTag sul valore restituito della funzione per le iterazioni successive del ciclo.

Esempio

L'esempio seguente mostra la sequenza corretta di assegnazioni per il parametro 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);

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
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary

Condividi tramite