Funzione SetupGetSourceFileSizeA (setupapi.h)

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

Gestire il file INF caricato che contiene le sezioni SourceDisksNames 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 una stringa con terminazione Null contenente il nome file (nessun percorso) per il quale restituire le dimensioni. Se questo parametro è NULL e InfContext, viene usato il parametro Section .

[in] Section

Puntatore facoltativo a una stringa con terminazione Null contenente il nome di una sezione Copia file . Se questo parametro viene specificato, 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 del file arrotondate per enumerare fino a 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

È necessario specificare uno e solo uno dei parametri facoltativi , InfContext, FileName e Section.

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

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

SetupGetSourceFileLocation