Compartir a través de

Método IWSDDeviceHost::SetMetadata (wsdhost.h)

  • Artículo

Establece los metadatos de un dispositivo, excepto los metadatos de servicio definidos por el usuario.

Sintaxis

HRESULT SetMetadata(
  [in]           const WSD_THIS_MODEL_METADATA   *pThisModelMetadata,
  [in]           const WSD_THIS_DEVICE_METADATA  *pThisDeviceMetadata,
  [in, optional] const WSD_HOST_METADATA         *pHostMetadata,
  [in, optional] const WSD_METADATA_SECTION_LIST *pCustomMetadata
);

Parámetros

[in] pThisModelMetadata

Referencia a una estructura de WSD_THIS_MODEL_METADATA que especifica los metadatos comunes a todas las instancias del modelo de este dispositivo. Los miembros Manufacturer, ModelNames y ModelNumber de la estructura deben contener entradas que no sean NULL y que no sean en blanco.

[in] pThisDeviceMetadata

Referencia a una estructura de WSD_THIS_DEVICE_METADATA que especifica metadatos únicos para este dispositivo. Los miembros FriendlyName, FirmwareVersion y SerialNumber de esta estructura deben contener entradas que no sean NULL y que no sean en blanco.

[in, optional] pHostMetadata

Referencia a una estructura de WSD_HOST_METADATA que especifica los metadatos del host de servicio, que los datos y características específicos del dispositivo (por ejemplo, una impresora admite color o tiene un grapador).

[in, optional] pCustomMetadata

Referencia a una estructura de WSD_METADATA_SECTION_LIST que especifica metadatos personalizados adicionales asociados a este dispositivo.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_INVALIDARG
 pThisDeviceMetadata es NULL, pThisModelMetadata es NULL o bien la estructura no contiene los miembros necesarios. Consulte las descripciones de parámetros para obtener una lista de miembros necesarios.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.

Comentarios

Este método debe llamarse al menos una vez antes de iniciar cualquier host de dispositivo que se registró con RegisterService. Se puede llamar después de que se inicie el dispositivo para actualizar los metadatos, en cuyo caso se emiten WS-Discovery mensajes Hello que indican la nueva versión de metadatos.

Nota La característica de actualización aún no se ha implementado.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdhost.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDDeviceHost