Funzione SetupRemoveFromDiskSpaceListA (setupapi.h)

Articolo
08/26/2023

[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
FILEOP_DELETE	Operazione di eliminazione file.
FILEOP_COPY	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

Vedi anche

Funzioni

Panoramica

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList

Condividi tramite