Функция SetupQueryDrivesInDiskSpaceListA (setupapi.h)

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция setupQueryDrivesInDiskSpaceList заполняет буфер списком дисков, на которые ссылаются операции файлов, перечисленные в списке дискового пространства.

Синтаксис

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

Параметры

[in] DiskSpace

Обработка списка дискового пространства.

[in, out] ReturnBuffer

Необязательный указатель на буфер, который получает спецификации диска, например "X:" или "\server\share". Следует использовать строку null-terminated. Строка null-terminated не должна превышать размер целевого буфера. Этот параметр может быть NULL. Если этот параметр не указан и ошибка не возникает, функция возвращает ненулевое значение и RequiredSize получает размер буфера, необходимый для хранения спецификаций диска.

[in] ReturnBufferSize

Размер буфера, на который указывает ReturnBuffer, в символах. Это включает в себя null конца. Этот параметр игнорируется, если ReturnBuffer не указан.

[in, out] RequiredSize

Необязательный указатель на переменную, которая получает размер буфера, необходимого для хранения null-завершенного списка дисков в символах. Это включает в себя null конца.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение является ненулевое значение.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Если функция GetLastError возвращает ERROR_INSUFFICIENT_BUFFER , было указано ReturnBuffer, но ReturnBufferSize указал, что предоставленный буфер слишком мал.

Замечания

Заметка

Заголовок setupapi.h определяет SetupQueryDrivesInDiskSpaceList как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupQuerySpaceRequiredOnDrive

Поделиться через