Metode IWSDDeviceHost::SetMetadata (wsdhost.h)
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 |
---|---|
|
Metode berhasil diselesaikan. |
|
pThisDeviceMetadata adalah NULL, pThisModelMetadata adalah NULL, atau salah satu struktur tidak berisi anggota yang diperlukan. Lihat deskripsi parameter untuk daftar anggota yang diperlukan. |
|
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.
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 |