Função SetupDiSetClassRegistryPropertyA (setupapi.h)

  • Artigo

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 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. 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 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 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 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 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, 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 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

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty