Funzione CryptCATCDFEnumMembersByCDFTagEx

  • Articolo

[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