Funzione SetupRemoveFromDiskSpaceListA (setupapi.h)

Articolo
11/20/2024

[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 di 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

Handle 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ò essere 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 restituisce 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll

Vedere anche

Funzioni

panoramica

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList

Condividi tramite