Compartilhar via

Função CM_Get_Device_Interface_Property_ExW (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Device_Interface_Property .]

A função CM_Get_Device_Interface_Property_ExW recupera uma propriedade de dispositivo definida para uma interface do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Parâmetros

[in] pszDeviceInterface

Ponteiro para uma cadeia de caracteres que identifica a instância da interface do dispositivo da qual recuperar a propriedade.

[in] PropertyKey

Ponteiro para uma estrutura DEVPROPKEY que representa a chave de propriedade da interface do dispositivo da propriedade de interface do dispositivo a ser recuperada.

[out] PropertyType

Ponteiro para uma variável do tipo DEVPROPTYPE que recebe o identificador property-data-type da propriedade de interface do dispositivo solicitada. O identificador property-data-type é um OR bit a bit entre um identificador de tipo de dados base e, se o tipo de dados base for modificado, um modificador de tipo de dados de propriedade.

[out] PropertyBuffer

Um ponteiro para um buffer que recebe a propriedade de interface do dispositivo solicitada. CM_Get_Device_Interface_Property_ExW recupera a propriedade solicitada somente se o buffer for grande o suficiente para manter todos os dados de valor da propriedade. O ponteiro pode ser NULL.

[in, out] PropertyBufferSize

O tamanho, em bytes, do buffer PropertyBuffer . Se PropertyBuffer estiver definido como NULL, *PropertyBufferSize deverá ser definido como zero. Como saída, se o buffer não for grande o suficiente para conter todos os dados de valor da propriedade, CM_Get_Device_Interface_Property_ExW retornará o tamanho dos dados, em bytes, em *PropertyBufferSize.

[in] ulFlags

Reservado. Deve ser definido como zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

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

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

CM_Get_Device_Interface_Property_ExW faz parte do Modelo de Propriedade de Dispositivo Unificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 10 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL CfgMgr32.dll

Confira também

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty