Metode IWSDDeviceHost::SetMetadata (wsdhost.h)

Artikel
03/15/2023

Mengatur metadata untuk perangkat, tidak termasuk metadata layanan yang ditentukan pengguna.

Sintaks

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

Referensi ke struktur WSD_THIS_MODEL_METADATA yang menentukan metadata yang umum untuk semua instans model perangkat ini. Anggota Produsen, ModelNames, dan ModelNumber struktur harus berisi entri non-NULL dan tidak kosong.

[in] pThisDeviceMetadata

Referensi ke struktur WSD_THIS_DEVICE_METADATA yang menentukan metadata unik untuk perangkat ini. Anggota FriendlyName, FirmwareVersion, dan SerialNumber dari struktur ini harus berisi entri non-NULL dan tidak kosong.

[in, optional] pHostMetadata

Referensi ke struktur WSD_HOST_METADATA yang menentukan metadata host layanan, yang data dan karakteristik perangkat tertentu (misalnya, printer mendukung warna atau memiliki stapler.).

[in, optional] pCustomMetadata

Referensi ke struktur WSD_METADATA_SECTION_LIST yang menentukan metadata kustom tambahan yang terkait dengan perangkat ini.

Mengembalikan nilai

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	pThisDeviceMetadata adalah NULL, pThisModelMetadata adalah NULL, atau salah satu struktur tidak berisi anggota yang diperlukan. Lihat deskripsi parameter untuk daftar anggota yang diperlukan.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.

Keterangan

Metode ini harus dipanggil setidaknya sekali sebelum memulai host perangkat apa pun yang terdaftar di RegisterService. Ini dapat dipanggil setelah perangkat mulai memperbarui metadata, dalam hal ini WS-Discovery pesan Halo dikeluarkan yang menunjukkan versi metadata baru.

Catatan Fitur pembaruan belum diimplementasikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wsdhost.h (termasuk Wsdapi.h)
DLL	Wsdapi.dll

Lihat juga

IWSDDeviceHost

Bagikan melalui