IWSDDeviceHost::SetMetadata-Methode (wsdhost.h)

Legt die Metadaten für ein Gerät fest, ohne benutzerdefinierte Dienstmetadaten.

Syntax

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
);

Parameter

[in] pThisModelMetadata

Verweis auf eine WSD_THIS_MODEL_METADATA-Struktur , die Metadaten angibt, die allen Instanzen des Modells dieses Geräts gemeinsam sind. Die Member "Manufacturer", "ModelNames" und "ModelNumber" der -Struktur müssen Nicht-NULL-Einträge enthalten, die nicht leer sind.

[in] pThisDeviceMetadata

Verweis auf eine WSD_THIS_DEVICE_METADATA-Struktur , die Metadaten angibt, die für dieses Gerät eindeutig sind. Die Member FriendlyName, FirmwareVersion und SerialNumber dieser Struktur müssen Nicht-NULL-Einträge enthalten, die nicht leer sind.

[in, optional] pHostMetadata

Verweis auf eine WSD_HOST_METADATA Struktur, die Diensthostmetadaten angibt, die die spezifischen Daten und Merkmale des Geräts (z. B. ein Drucker unterstützt Farbe oder hat einen Hefter).

[in, optional] pCustomMetadata

Verweis auf eine WSD_METADATA_SECTION_LIST-Struktur , die zusätzliche benutzerdefinierte Metadaten angibt, die diesem Gerät zugeordnet sind.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem:

Hinweise

Diese Methode muss mindestens einmal aufgerufen werden, bevor ein Gerätehost gestartet wird, der bei RegisterService registriert wurde. Es kann aufgerufen werden, nachdem das Gerät gestartet wurde, um die Metadaten zu aktualisieren. In diesem Fall werden WS-Discovery Hello-Meldungen ausgegeben, die die neue Metadatenversion angeben.

Anforderungen

Weitere Informationen

IWSDDeviceHost