Compartilhar via


Método IPortableDeviceService::GetPnPServiceID (portabledeviceapi.h)

O método GetPnPServiceID recupera um identificador de Plug and Play (PnP) para o serviço.

Sintaxe

HRESULT GetPnPServiceID(
  [out] LPWSTR *ppszPnPServiceID
);

Parâmetros

[out] ppszPnPServiceID

O identificador PnP recuperado, que é o mesmo identificador que foi passado para o método Open .

Retornar valor

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_POINTER
Um parâmetro NULL foi especificado.
E_WPD_SERVICE_NOT_OPEN
O método Open ainda não foi chamado para o serviço.

Comentários

O método Open deve ser chamado no serviço antes que um identificador PnP possa ser recuperado.

Quando um aplicativo não precisa mais do identificador PnP, ele deve chamar a função CoTaskMemFree para liberar a memória do identificador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho portabledeviceapi.h

Confira também

IPortableDeviceService Interface