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

Статья
03/15/2023

Функция SetupDiSetClassRegistryProperty задает указанное свойство класса устройства в реестре.

Синтаксис

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyW(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCWSTR     MachineName,
                 PVOID      Reserved
);

Параметры

[in] ClassGuid

Указатель на GUID, который идентифицирует класс устройства, для которого необходимо задать свойство.

[in] Property

Значение , определяющее заданное свойство, которое должно иметь одно из следующих значений:

SPCRP_CHARACTERISTICS

Вызывающий объект предоставляет флаги, указывающие характеристики устройства для класса . Список флагов характеристик см. в параметре DeviceCharacteristicsобъекта IoCreateDevice. Характеристики устройства должны задаваться при установке класса устройства и не должны изменяться после установки класса устройства.

SPCRP_DEVTYPE

Вызывающий объект предоставляет тип устройства для класса . Дополнительные сведения см. в разделе Указание типов устройств. Тип устройства должен быть задан при установке класса устройства и не должен изменяться после установки класса устройства.

SPCRP_EXCLUSIVE

Вызывающий объект предоставляет значение DWORD, указывающее, могут ли пользователи получать монопольный доступ к устройствам для этого класса. Предоставленное значение равно 1, если монопольный доступ разрешен, или ноль в противном случае. Монопольный параметр для устройства должен быть установлен при установке класса устройства и не должен изменяться после установки класса устройства.

SPCRP_LOWERFILTERS

(Windows Vista и более поздних версий) Вызывающий объект предоставляет REG_MULTI_SZ список имен служб более низких драйверов фильтров, установленных для класса установки устройства. Дополнительные сведения об установке драйвера фильтра классов см. в разделе Установка драйвера фильтра и INF ClassInstall32.

SPCRP_SECURITY

Вызывающий объект предоставляет дескриптор безопасности устройства в виде структуры SECURITY_DESCRIPTOR в самообобъективном формате (описано в документации по Microsoft Windows SDK).

SPCRP_SECURITY_SDS

Вызывающий объект предоставляет дескриптор безопасности устройства в виде текстовой строки. Сведения о строках дескриптора безопасности см. в статье Язык определения дескриптора безопасности (Windows). Сведения о формате строк дескриптора безопасности см. в разделе Язык определения дескрипторов безопасности (Windows).

SPCRP_UPPERFILTERS

(Windows Vista и более поздних версий) Вызывающий объект предоставляет REG_MULTI_SZ список имен служб драйверов верхнего фильтра, установленных для класса установки устройства. Дополнительные сведения об установке драйвера фильтра классов см. в разделе Установка драйвера фильтра и INF ClassInstall32.

[in, optional] PropertyBuffer

Указатель на буфер, предоставляющий указанное свойство. Этот параметр является необязательным и может иметь значение NULL.

[in] PropertyBufferSize

Размер буфера PropertyBuffer (в байтах).

[in, optional] MachineName

Указатель на строку с завершением NULL, содержащую имя удаленной системы, для которой необходимо задать указанное свойство класса устройства. Этот параметр является необязательным и может иметь значение NULL. Если этот параметр имеет значение NULL, свойство задается в имени локальной системы.

Внимание!

Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

Reserved

Зарезервировано, должно иметь значение NULL.

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

Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows XP и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib

См. также раздел

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty

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