Compartilhar via


Função CM_Get_DevNode_Registry_PropertyA (cfgmgr32.h)

A função CM_Get_DevNode_Registry_Property recupera uma propriedade de dispositivo especificada do registro.

Sintaxe

CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyA(
  [in]            DEVINST dnDevInst,
  [in]            ULONG   ulProperty,
  [out, optional] PULONG  pulRegDataType,
  [out, optional] PVOID   Buffer,
  [in, out]       PULONG  pulLength,
  [in]            ULONG   ulFlags
);

Parâmetros

[in] dnDevInst

Um identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

[in] ulProperty

Um valor constante prefixado por CM_DRP_ que identifica a propriedade do dispositivo a ser obtida do registro. Essas constantes são definidas em Cfgmgr32.h.

[out, optional] pulRegDataType

Opcional, pode ser NULL. Um ponteiro para um local que recebe o tipo de dados do Registro, especificado como uma constante prefixada por REG_ definida em Winnt.h.

[out, optional] Buffer

Opcional, pode ser NULL. Um ponteiro para um buffer fornecido pelo chamador que recebe a propriedade do dispositivo solicitada. Se esse valor for NULL, a função fornecerá apenas o comprimento dos dados solicitados no endereço apontado por pulLength.

[in, out] pulLength

Um ponteiro para uma variável ULONG na qual a função armazena o comprimento, em bytes, da propriedade do dispositivo solicitada.

Se o parâmetro Buffer for definido como NULL, a variável ULONG deverá ser definida como zero.

Se o parâmetro Buffer não estiver definido como NULL, a variável ULONG deverá ser definida como o comprimento, em bytes, do buffer fornecido pelo chamador.

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Microsoft Windows 2000.
Plataforma de Destino Universal
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib

Confira também

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty