Função SetupDiSetClassRegistryPropertyA (setupapi.h)
A função SetupDiSetClassRegistryProperty define uma propriedade de classe de dispositivo especificada no registro.
Sintaxe
WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[in, optional] const BYTE *PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in, optional] PCSTR 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
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 aos dispositivos dessa classe. O valor fornecido será 1 se o acesso exclusivo for permitido ou zero caso contrário. A configuração exclusiva de 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 instalação do dispositivo . Para obter mais informações sobre como instalar um driver de filtro de classe, consulte Instalando um de Driver de Filtro e seção INF ClassInstall32.
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 de Linguagem de Definição do Descritor de Segurança (Windows). Para obter informações sobre o formato de cadeias de caracteres de descritor de segurança, consulte a 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 instalação do dispositivo. Para obter mais informações sobre como instalar um driver de filtro de classe, consulte Instalando um de Driver de Filtro e seção INF ClassInstall32.
[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 a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
Reserved
Reservado, deve ser NULL.
Valor de retorno
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows XP e versões posteriores do Windows. |
| da Plataforma de Destino |
Área de trabalho |
| cabeçalho | setupapi.h (inclua Setupapi.h) |
| biblioteca | Setupapi.lib |
Consulte também
SetupDiGetClassRegistryProperty