Método IUPnPRegistrar::RegisterDeviceProvider (upnphost.h)

El método RegisterDeviceProvider registra un proveedor de dispositivos con el host del dispositivo. El proveedor de dispositivos no se publica en la red. En su lugar, crea dispositivos dinámicamente y los registra mediante RegisterRunningDevice.

Sintaxis

HRESULT RegisterDeviceProvider(
  [in] BSTR bstrProviderName,
  [in] BSTR bstrProgIDProviderClass,
  [in] BSTR bstrInitString,
  [in] BSTR bstrContainerId
);

Parámetros

[in] bstrProviderName

Especifica el nombre del proveedor de dispositivos.

[in] bstrProgIDProviderClass

Especifica el ProgID del objeto que implementa la interfaz IUPnPDeviceProvider . Este objeto ya debe estar registrado con COM. Este objeto debe ser un servidor COM (CLSCTX_INPROC_SERVER) en proceso y debe ser accesible para LocalService.

[in] bstrInitString

Identifica una cadena de inicialización específica de un proveedor de dispositivos.

[in] bstrContainerId

Especifica una cadena que identifica el grupo de procesos al que pertenece el proveedor de dispositivos. Todos los dispositivos y proveedores de dispositivos con el mismo identificador de contenedor se encuentran en el mismo proceso.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.

Comentarios

Entre los errores comunes que pueden producirse al invocar esta función se incluyen:

• No se encontró el objeto COM necesario.
• No hay acceso al objeto COM para LocalService.
• Interfaces COM subordinadas.

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

Consulte también

IUPnPRegistrar

IUPnPRegistrar::UnregisterDeviceProvider