Condividi tramite


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

La funzione SetupQueryDrivesInDiskSpaceList riempie un buffer con un elenco delle unità a cui fa riferimento le operazioni di file elencate nell'elenco spazio su disco.

Sintassi

WINSETUPAPI BOOL SetupQueryDrivesInDiskSpaceListA(
  [in]      HDSKSPC DiskSpace,
  [in, out] PSTR    ReturnBuffer,
  [in]      DWORD   ReturnBufferSize,
  [in, out] PDWORD  RequiredSize
);

Parametri

[in] DiskSpace

Gestire l'elenco spazio su disco.

[in, out] ReturnBuffer

Puntatore facoltativo a un buffer che riceve le specifiche dell'unità, ad esempio "X:" o "\server\share". È consigliabile usare una stringa con terminazione Null. La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. Questo parametro può essere NULL. Se questo parametro non viene specificato e non si verifica alcun errore, la funzione restituisce un valore diverso da zero e RequiredSize riceve le dimensioni del buffer necessarie per contenere le specifiche dell'unità.

[in] ReturnBufferSize

Dimensioni del buffer puntate da ReturnBuffer, in caratteri. Include il terminatore Null . Questo parametro viene ignorato se ReturnBuffer non è specificato.

[in, out] RequiredSize

Puntatore facoltativo a una variabile che riceve le dimensioni del buffer necessarie per contenere l'elenco di unità con terminazione null, in caratteri. Include il terminatore Null .

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.

Se la funzione GetLastError restituisce ERROR_INSUFFICIENT_BUFFER, ReturnBuffer è stata specificata, ma ReturnBufferSize indica che il buffer fornito era troppo piccolo.

Commenti

Nota

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

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

SetupQuerySpaceRequiredOnDrive