Funzione SetupRemoveFromDiskSpaceListW (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupRemoveFromDiskSpaceList rimuove un'operazione di eliminazione o copia di file da un elenco di spazio su disco.
Sintassi
WINSETUPAPI BOOL SetupRemoveFromDiskSpaceListW(
[in] HDSKSPC DiskSpace,
[in] PCWSTR TargetFilespec,
[in] UINT Operation,
[in] PVOID Reserved1,
[in] UINT Reserved2
);
Parametri
[in] DiskSpace
Gestire un elenco di spazio su disco.
[in] TargetFilespec
Puntatore a una stringa con terminazione null che specifica il nome file del file da rimuovere dall'elenco spazio su disco. Questo è in genere un percorso completo. In caso contrario, il percorso deve essere relativo alla directory corrente.
[in] Operation
Operazione file da rimuovere dall'elenco. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Operazione di eliminazione file. |
|
Operazione di copia file. |
[in] Reserved1
Deve essere zero.
[in] Reserved2
Deve essere zero.
Valore restituito
Se il file non è presente nell'elenco, la funzione SetupRemoveFromDiskSpaceList restituisce un valore diverso da zero e GetLastError restituisce ERROR_INVALID_DRIVE o ERROR_INVALID_NAME. Se il file è presente nell'elenco, al termine della routine viene restituito un valore diverso da zero e GetLastError restituisce NO_ERROR.
Se la routine ha esito negativo per un altro motivo, restituisce zero e GetLastError restituisce informazioni di errore estese.
Commenti
Nota
L'intestazione setupapi.h definisce SetupRemoveFromDiskSpaceList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | setupapi.h |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |