Funzione CryptCATCDFEnumMembersByCDFTagEx
[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 |
|
Vedi anche