Método IUPnPDeviceControl::GetServiceObject (upnphost.h)
O método GetServiceObject é usado para obter o ponteiro IDispatch para um objeto de serviço específico. O host do dispositivo invoca esse método uma vez por serviço, na primeira vez que recebe uma solicitação para um serviço.
Sintaxe
HRESULT GetServiceObject(
[in] BSTR bstrUDN,
[in] BSTR bstrServiceId,
[out] IDispatch **ppdispService
);
Parâmetros
[in] bstrUDN
Especifica o UDN do dispositivo.
[in] bstrServiceId
Especifica a ID de Serviço do serviço para o qual obter o ponteiro.
[out] ppdispService
Recebe o ponteiro IDispatch para o objeto de serviço.
Retornar valor
Ao implementar esse método, retorne S_OK se o método for bem-sucedido. Caso contrário, retorne um dos códigos de erro COM definidos em WinError.h.
Comentários
Esse método é invocado pelo host do dispositivo quando uma solicitação de controle ou assinatura de evento é recebida para um serviço específico.
Os dispositivos inseridos são diferenciados por suas UDNs.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnphost.h |
| DLL | Upnphost.dll |