Metodo IWSDDeviceHost::SetMetadata (wsdhost.h)

Imposta i metadati per un dispositivo, esclusi i metadati del servizio definiti dall'utente.

Sintassi

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

Parametri

[in] pThisModelMetadata

Riferimento a una struttura WSD_THIS_MODEL_METADATA che specifica i metadati comuni a tutte le istanze del modello del dispositivo. I membri Manufacturer, ModelNames e ModelNumber della struttura devono contenere voci non NULL, non vuote.

[in] pThisDeviceMetadata

Riferimento a una struttura WSD_THIS_DEVICE_METADATA che specifica i metadati univoci per questo dispositivo. I membri FriendlyName, FirmwareVersion e SerialNumber di questa struttura devono contenere voci non NULL, non vuote.

[in, optional] pHostMetadata

Riferimento a una struttura di WSD_HOST_METADATA che specifica i metadati dell'host del servizio, quali dati e caratteristiche specifici del dispositivo (ad esempio, una stampante supporta il colore o ha un graffffatore).

[in, optional] pCustomMetadata

Riferimento a una struttura WSD_METADATA_SECTION_LIST che specifica metadati personalizzati aggiuntivi associati al dispositivo.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Commenti

Questo metodo deve essere chiamato almeno una volta prima di avviare qualsiasi host del dispositivo registrato con RegisterService. Può essere chiamato dopo l'avvio dell'aggiornamento dei metadati da parte del dispositivo, nel qual caso WS-Discovery vengono rilasciati messaggi Hello che indicano la nuova versione dei metadati.

Requisiti

Vedi anche

IWSDDeviceHost