Funzione SetupIterateCabinetA (setupapi.h)

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupIterateCabinet scorre tutti i file in un cabinet e invia una notifica a una funzione di callback per ogni file trovato.

Sintassi

WINSETUPAPI BOOL SetupIterateCabinetA(
  [in] PCSTR               CabinetFile,
  [in] DWORD               Reserved,
  [in] PSP_FILE_CALLBACK_A MsgHandler,
  [in] PVOID               Context
);

Parametri

[in] CabinetFile

File Cab (.CAB) per scorrere.

[in] Reserved

Non attualmente utilizzato.

[in] MsgHandler

Puntatore a una routine FileCallback che elabora le notifiche SetupIterateCabinet restituisce durante l'iterazione dei file nel file cab. La routine di callback può quindi restituire un valore che specifica se decomprimere, copiare o ignorare il file.

[in] Context

Valore di contesto passato alla routine specificata in MsgHandler. Ciò consente alla routine di callback di tenere traccia dei valori tra le notifiche, senza dover usare variabili globali.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Fabbisogno

Vedere anche

Funzioni

panoramica