Função SetupDiGetClassRegistryPropertyA (setupapi.h)
A função SetupDiGetClassRegistryProperty recupera uma propriedade para uma classe de instalação de dispositivo especificada do registro.
Sintaxe
WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyA(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parâmetros
[in] ClassGuid
Um ponteiro para um GUID que representa a classe de configuração do dispositivo para a qual uma propriedade deve ser recuperada.
[in] Property
Um valor que identifica a propriedade a ser recuperada. Esse deve ser um dos seguintes valores:
SPCRP_CHARACTERISTICS
A função retorna sinalizadores que indicam as características do dispositivo para a classe. Para obter uma lista de sinalizadores de características, consulte o parâmetro DeviceCharacteristics para IoCreateDevice.
SPCRP_DEVTYPE
A função retorna um valor DWORD que representa o tipo de dispositivo para a classe. Para obter mais informações, consulte Especificando tipos de dispositivo.
SPCRP_EXCLUSIVE
A função retorna um valor DWORD que indica se os usuários podem obter acesso exclusivo a dispositivos para essa classe. O valor retornado será um se o acesso exclusivo for permitido ou zero caso contrário.
SPCRP_LOWERFILTERS
(Windows Vista e posterior) A função retorna uma lista REG_MULTI_SZ dos nomes de serviço dos drivers de filtro inferior instalados para a classe de instalação do dispositivo.
SPCRP_SECURITY
A função retorna 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
A função retorna 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) A função retorna uma lista REG_MULTI_SZ dos nomes de serviço dos drivers de filtro superior instalados para a classe de instalação do dispositivo.
[out, optional] PropertyRegDataType
Um ponteiro para uma variável do tipo DWORD que recebe o tipo de dados de propriedade como um dos tipos de dados do Registro prefixados por REG_. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, SetupDiGetClassRegistryProperty não retornará o tipo de dados.
[out] PropertyBuffer
Um ponteiro para um buffer que recebe a propriedade solicitada.
[in] PropertyBufferSize
O tamanho, em bytes, do buffer PropertyBuffer .
[out, optional] RequiredSize
Um ponteiro para uma variável do tipo DWORD que recebe o tamanho necessário, em bytes, do PropertyBuffer buffer. Se o buffer do PropertyBuffer for muito pequeno e RequiredSize não for NULL, os conjuntos de funções RequiredSize para o tamanho mínimo do buffer necessário para receber a propriedade solicitada.
[in, optional] MachineName
Um ponteiro para uma cadeia de caracteres terminada por NULL que contém o nome de um sistema remoto do qual recuperar a propriedade de classe de dispositivo especificada. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, a propriedade será recuperada 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
Nota
O cabeçalho setupapi.h define SetupDiGetClassRegistryProperty 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 |
DesktopPara universal, chame CM_Get_Class_Registry_Property |
| cabeçalho | setupapi.h (inclua Setupapi.h) |
| biblioteca | Setupapi.lib |
Consulte também
SetupDiGetDeviceRegistryProperty