Funzione SetupAddSectionToDiskSpaceListA (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 di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupAddSectionToDiskSpaceList aggiunge a un elenco di spazio su disco tutte le operazioni di eliminazione o copia del file elencate in una sezione Copia file o Elimina file di un file INF.

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 SetupAddSectionToDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCSTR   SectionName,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Parametri

[in] DiskSpace

Gestire l'elenco spazio su disco.

[in] InfHandle

Gestire in un file INF aperto che contiene la sezione SourceDisksFiles . Se ListInfHandle non è specificato, questo file INF deve contenere anche la sezione denominata da SectionName.

[in] ListInfHandle

Handle facoltativo per un file INF aperto che contiene la sezione specificata da SectionName. In caso contrario, Si presuppone che InfHandle contenga questa sezione.

[in] SectionName

Nome della sezione Copia file o Elimina file che contiene le operazioni di file da aggiungere all'elenco spazio su disco. Usare una stringa con terminazione null.

[in] Operation

Tipo di operazione di 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

Questa funzione richiede un file WINDOWS INF. Alcuni formati di file INF meno recenti potrebbero non essere supportati.

Nota

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