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 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 configuraçã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 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) A função retorna uma lista REG_MULTI_SZ dos nomes de serviço dos drivers de filtro superior instalados para a classe de configuraçã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 buffer PropertyBuffer . Se o buffer PropertyBuffer for muito pequeno e RequiredSize não for NULL, a função definirá RequiredSize como o tamanho mínimo do buffer necessário para receber a propriedade solicitada.

[in, optional] MachineName

Um ponteiro para uma cadeia de caracteres terminada em 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, 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

Observação

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 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	DesktopPara universal, chame CM_Get_Class_Registry_Property
Cabeçalho	setupapi.h (inclua Setupapi.h)
Biblioteca	Setupapi.lib

Confira também

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty