Funzione SetupRemoveFromDiskSpaceListA (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 delle 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 SetupRemoveFromDiskSpaceListA(
[in] HDSKSPC DiskSpace,
[in] PCSTR TargetFilespec,
[in] UINT Operation,
[in] PVOID Reserved1,
[in] UINT Reserved2
);
Parametri
[in] DiskSpace
Gestire in 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 di spazio su disco. Si tratta in genere di 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 si trovava nell'elenco, al completamento 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |