Compartilhar via


Método IPortableDevice::GetPnPDeviceID (portabledeviceapi.h)

O método GetPnPDeviceID recupera o identificador de dispositivo PnP (Plug and Play) que o aplicativo usou para abrir o dispositivo.

Sintaxe

HRESULT GetPnPDeviceID(
  [out] LPWSTR *ppszPnPDeviceID
);

Parâmetros

[out] ppszPnPDeviceID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a cadeia de caracteres de ID de Plug and Play para o dispositivo.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_WPD_DEVICE_NOT_OPEN
O método IPortableDevice::Open ainda não foi chamado para este dispositivo.

Comentários

Depois que o aplicativo estiver usando a cadeia de caracteres retornada por esse método, ele deverá chamar a função CoTaskMemFree para liberar a cadeia de caracteres.

O argumento ppszPnPDeviceID não deve ser definido como NULL.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho portabledeviceapi.h
Biblioteca PortableDeviceGUIDs.lib

Confira também

IPortableDevice Interface

IPortableDevice::Open