Método IPortableDeviceDispatchFactory::GetDeviceDispatch (portabledeviceapi.h)

Cria uma instância de um objeto de dispositivo de automação WPD para um determinado identificador de dispositivo WPD.

Sintaxe

HRESULT GetDeviceDispatch(
  [in]  LPCWSTR   pszPnPDeviceID,
  [out] IDispatch **ppDeviceDispatch
);

Parâmetros

[in] pszPnPDeviceID

Um ponteiro para uma cadeia de caracteres usada pelo Plug-and-play para identificar um dispositivo WPD conectado no momento. O identificador de Plug and Play (PnP) para um dispositivo específico pode ser obtido do método IPortableDeviceManager::GetDevices na API do WPD C++/COM.

[out] ppDeviceDispatch

Contém um ponteiro para a implementação de IDispatch para o objeto dispositivo de automação WPD.

Retornar valor

Os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Para obter um exemplo de como usar o método GetDeviceDispatch para instanciar um objeto de Dispositivo de Automação do WPD, consulte Instanciando a Interface de Fábrica de Automação do WPD.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGuids.lib

Confira também

Objeto Device

IPortableDeviceDispatchFactory Interface

Instanciando a interface do WPD Automation Factory