Funzione SetupGetSourceFileSizeA (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 SetupGetSourceFileSize legge le dimensioni non compresse di un file di origine elencato in un file INF.

Sintassi

WINSETUPAPI BOOL SetupGetSourceFileSizeA(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCSTR       FileName,
  [in]      PCSTR       Section,
  [in, out] PDWORD      FileSize,
  [in]      UINT        RoundingFactor
);

Parametri

[in] InfHandle

Handle per il file INF caricato che contiene le sezioni SourceDisksNamesNames e SourceDisksFiles. Se esistono sezioni specifiche della piattaforma per il sistema dell'utente, ad esempio SourceDisksNames.x86 e SourceDisksFiles.x86), verrà usata la sezione specifica della piattaforma.

[in] InfContext

Puntatore facoltativo a un contesto per una riga in una sezione Copia file per cui recuperare le dimensioni. Se InfContext è NULL, viene utilizzato il parametro FileName .

[in] FileName

Puntatore facoltativo a un nullstringa con terminazione contenente il nome file (nessun percorso) per cui restituire le dimensioni. Se questo parametro è NULL e InfContext, viene usato il parametro Section .

[in] Section

Puntatore facoltativo a un nullstringa con terminazione contenente il nome di una sezione Copia file. Se si specifica questo parametro, vengono calcolate le dimensioni totali di tutti i file elencati nella sezione .

[in, out] FileSize

Puntatore a una variabile che riceve le dimensioni, in byte, dei file specificati.

[in] RoundingFactor

Valore facoltativo per l'arrotondamento delle dimensioni dei file. Tutte le dimensioni del file vengono arrotondate a un multiplo di questo numero prima di essere aggiunte alle dimensioni totali. L'arrotondamento è utile per determinare con maggiore precisione lo spazio occupato da un file in un determinato volume, perché consente al chiamante di avere dimensioni di file arrotondate per un multiplo delle dimensioni del cluster. L'arrotondamento non si verifica a meno che non venga specificato RoundingFactor.

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

È necessario specificare uno e solo uno dei parametri facoltativi, InfContext, FileNamee Sezione.

Nota

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

SetupGetSourceFileLocation

Condividi tramite