Definindo propriedades do registro de objeto do dispositivo após a instalação

Um programa de modo de usuário pode usar as funções de instalação do dispositivo para obter ou definir as configurações do Registro para as propriedades do objeto de dispositivo de um driver. Normalmente, essas funções são usadas pelo software de instalação, mas podem ser usadas por qualquer programa de modo de usuário. (O programa deve ser executado por um usuário que tenha acesso de Administrador.)

As funções SetupDiGetDeviceRegistryProperty e SetupDiSetDeviceRegistryProperty obtêm e definem a chave do Registro para cada propriedade especificada. O parâmetro Property especifica a propriedade a ser obtido ou definido. O PropertyBuffer aponta para o buffer de destino (ao obter a propriedade) ou buffer de origem (ao definir a propriedade) para a propriedade .

A correspondência entre valores para o parâmetro Property e as propriedades reais é a seguinte.

Observe que duas maneiras diferentes são fornecidas para obter ou definir o descritor de segurança. Você pode especificar o valor SPDRP_SECURITY para tratar o descritor de segurança como uma estrutura SECURITY_DESCRIPTOR ou SPDRP_SECURITY_SDS para tratar o descritor de segurança como uma cadeia de caracteres SDDL. Para obter mais informações sobre cadeias de caracteres SDDL, consulte SDDL para objetos de dispositivo.

Para o Windows XP e sistemas operacionais posteriores, os programas também podem obter e definir os valores de propriedade para uma classe de configuração de dispositivo. Use as funções SetupDiGetClassRegistryProperty e SetupDiSetClassRegistryProperty para obter e definir os valores de propriedade para uma classe de configuração de dispositivo.

Para obter mais informações sobre como usar as funções SetupDiXxx , consulte Usando funções de instalação de dispositivo.