Função SetupDiSetClassRegistryPropertyW (setupapi.h)
A função SetupDiSetClassRegistryProperty define uma propriedade de classe de dispositivo especificada no registro.
Sintaxe
WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyW(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[in, optional] const BYTE *PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parâmetros
[in] ClassGuid
Um ponteiro para o GUID que identifica a classe de dispositivo para a qual uma propriedade deve ser definida.
[in] Property
Um valor que identifica a propriedade a ser definida, que deve ser um dos seguintes:
SPCRP_CHARACTERISTICS
O chamador fornece sinalizadores que especificam as características do dispositivo para a classe . Para obter uma lista de sinalizadores de características, consulte o parâmetro DeviceCharacteristics de IoCreateDevice. As características do dispositivo devem ser definidas quando a classe de dispositivo é instalada e não devem ser alteradas após a instalação da classe de dispositivo.
SPCRP_DEVTYPE
O chamador fornece o tipo de dispositivo para a classe . Para obter mais informações, consulte Especificando tipos de dispositivo. O tipo de dispositivo deve ser definido quando uma classe de dispositivo é instalada e não deve ser alterada após a instalação da classe de dispositivo.
SPCRP_EXCLUSIVE
O chamador fornece um valor DWORD que especifica se os usuários podem obter acesso exclusivo a dispositivos para essa classe. O valor fornecido será 1 se o acesso exclusivo for permitido ou zero, caso contrário, zero. A configuração exclusiva para um dispositivo deve ser definida quando uma classe de dispositivo é instalada e não deve ser alterada após a instalação da classe de dispositivo.
SPCRP_LOWERFILTERS
(Windows Vista e posterior) O chamador fornece uma lista REG_MULTI_SZ dos nomes de serviço dos drivers de filtro inferior instalados para a classe de configuração do dispositivo. Para obter mais informações sobre como instalar um driver de filtro de classe, consulte Instalando um driver de filtro e a seção Classe INFInstall32.
SPCRP_SECURITY
O chamador fornece o descritor de segurança do dispositivo como uma estrutura SECURITY_DESCRIPTOR no formato auto-relativo (descrito na documentação do SDK do Microsoft Windows).
SPCRP_SECURITY_SDS
O chamador fornece o descritor de segurança do dispositivo como uma cadeia de caracteres de texto. Para obter informações sobre cadeias de caracteres de descritor de segurança, consulte Linguagem de definição do descritor de segurança (Windows). Para obter informações sobre o formato das cadeias de caracteres do descritor de segurança, consulte Linguagem de definição do descritor de segurança (Windows).
SPCRP_UPPERFILTERS
(Windows Vista e posterior) O chamador fornece uma lista REG_MULTI_SZ dos nomes de serviço dos drivers de filtro superior instalados para a classe de configuração do dispositivo. Para obter mais informações sobre como instalar um driver de filtro de classe, consulte Instalando um driver de filtro e a seção Classe INFInstall32.
[in, optional] PropertyBuffer
Um ponteiro para um buffer que fornece a propriedade especificada. Esse parâmetro é opcional e pode ser NULL.
[in] PropertyBufferSize
O tamanho, em bytes, do buffer PropertyBuffer .
[in, optional] MachineName
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um sistema remoto no qual definir a propriedade de classe de dispositivo especificada. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, a propriedade será definida no nome do sistema local.
Cuidado
Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
Reserved
Reservado, deve ser NULL.
Retornar valor
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.
Comentários
O chamador dessa função deve ser um membro do grupo Administradores.
Para determinar o tipo de dados de uma propriedade de classe de dispositivo, chame SetupDiGetClassRegistryProperty.
Observação
O cabeçalho setupapi.h define SetupDiSetClassRegistryProperty como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
Confira também
SetupDiGetClassRegistryProperty