Método IUPnPDeviceControl::Initialize (upnphost.h)
O método Initialize é usado para inicializar o dispositivo. O host do dispositivo invoca esse método.
Sintaxe
HRESULT Initialize(
[in] BSTR bstrXMLDesc,
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrInitString
);
Parâmetros
[in] bstrXMLDesc
Especifica a descrição completa do dispositivo XML, conforme publicado pelo host do dispositivo. A descrição do dispositivo é baseada no modelo fornecido pelo dispositivo.
[in] bstrDeviceIdentifier
Identifica o dispositivo a ser inicializado. Esse é o mesmo identificador retornado por IUPnPRegistrar::RegisterDevice ou IUPnPRegistrar::RegisterRunningDevice. Ele também é usado para recuperar o UDN do dispositivo usando IUPnPRegistrar::GetUniqueDeviceName.
[in] bstrInitString
Especifica a cadeia de caracteres de inicialização usada quando este dispositivo foi registrado.
Valor retornado
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 imediatamente após a instanciação do objeto de controle do dispositivo. Ele deve ser invocado antes que IUPnPDeviceControl::GetServiceObject seja invocado.
A diferença entre um dispositivo em execução e um dispositivo que não está em execução é quando o método Initialize é invocado.
Para executar dispositivos, Initialize é invocado quando IUPnPRegistrar::RegisterRunningDevice é invocado e a inicialização é concluída antes que IUPnPRegistrar::RegisterRunningDevice retorne.
Para dispositivos que não estão em execução, Initialize não é necessariamente invocado quando IUPnPRegistrar::RegisterDevice é invocado. Inicializar é invocado quando o primeiro controle ou solicitação de evento chega.
O bstrDeviceIdentifier também pode ser usado para chamar IUPnPRegistrar::GetUniqueDeviceName.
Requisitos
| 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 |