Método IUPnPDeviceControl::Initialize (upnphost.h)
El método Initialize se usa para inicializar el dispositivo. El host del dispositivo invoca este método.
Sintaxis
HRESULT Initialize(
[in] BSTR bstrXMLDesc,
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrInitString
);
Parámetros
[in] bstrXMLDesc
Especifica la descripción completa del dispositivo XML, según lo publicado por el host del dispositivo. La descripción del dispositivo se basa en la plantilla proporcionada por el dispositivo.
[in] bstrDeviceIdentifier
Identifica el dispositivo que se va a inicializar. Este es el mismo identificador devuelto por IUPnPRegistrar::RegisterDevice o IUPnPRegistrar::RegisterRunningDevice. También se usa para recuperar el UDN del dispositivo mediante IUPnPRegistrar::GetUniqueDeviceName.
[in] bstrInitString
Especifica la cadena de inicialización usada cuando se registró este dispositivo.
Valor devuelto
Al implementar este método, devuelva S_OK si el método se realiza correctamente. De lo contrario, devuelve uno de los códigos de error COM definidos en WinError.h.
Comentarios
Este método se invoca inmediatamente después de crear una instancia del objeto de control de dispositivo. Se debe invocar antes de que se invoque IUPnPDeviceControl::GetServiceObject .
La diferencia entre un dispositivo en ejecución y un dispositivo que no se está ejecutando es cuando se invoca el método Initialize .
Para los dispositivos en ejecución, initialize se invoca cuando se invoca IUPnPRegistrar::RegisterRunningDevice y la inicialización se completa antes de que se devuelva IUPnPRegistrar::RegisterRunningDevice .
En el caso de los dispositivos que no se ejecutan, Initialize no se invoca necesariamente cuando se invoca IUPnPRegistrar::RegisterDevice . La inicialización se invoca cuando llega el primer control o solicitud de evento.
El bstrDeviceIdentifier también se puede usar para llamar a IUPnPRegistrar::GetUniqueDeviceName.
Requisitos
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | No se admite ninguno |
Plataforma de destino | Windows |
Encabezado | upnphost.h |
Archivo DLL | Upnphost.dll |