Funzione SetupAddToDiskSpaceListA (setupapi.h)

Articolo
03/15/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 di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupAddToDiskSpaceList aggiunge una singola operazione di eliminazione o copia a un elenco di spazio su disco. Per aggiungere tutte le operazioni di file in una sezione di un file INF, usare SetupAddSectionToDiskSpaceList o SetupAddInstallSectionToDiskSpaceList.

La compressione del disco di destinazione viene ignorata da questa funzione. Si presuppone che i file occupino le dimensioni complete sul disco di destinazione.

Sintassi

WINSETUPAPI BOOL SetupAddToDiskSpaceListA(
  [in] HDSKSPC  DiskSpace,
  [in] PCSTR    TargetFilespec,
  [in] LONGLONG FileSize,
  [in] UINT     Operation,
  [in] PVOID    Reserved1,
  [in] UINT     Reserved2
);

Parametri

[in] DiskSpace

Gestire l'elenco spazio su disco.

[in] TargetFilespec

Nome file del file da aggiungere all'elenco spazio su disco. È consigliabile usare una stringa con terminazione null che specifica un percorso completo. In caso contrario, il percorso deve essere relativo alla directory corrente.

[in] FileSize

Dimensioni non compresse del file perché saranno presenti nella directory di destinazione, in byte. È possibile usare SetupGetSourceFileSize per recuperare queste informazioni da un file INF. Questo parametro viene ignorato per le operazioni di FILEOP_DELETE.

[in] Operation

Operazione file da aggiungere all'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 la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

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

Commenti

Nota

L'intestazione setupapi.h definisce SetupAddToDiskSpaceList 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


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

Condividi tramite