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

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

  • Статья

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. 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. Строка, завершающаяся значением NULL, не должна превышать размер буфера назначения. Этот параметр может принимать значение 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 [только классические приложения]
Целевая платформа Windows
Header setupapi.h
Библиотека Setupapi.lib
DLL Setupapi.dll

См. также

Функции

Обзор

SetupQuerySpaceRequiredOnDrive