Fungsi WsGetMetadataProperty (webservices.h)

Artikel
08/27/2023

Mengambil properti objek WS_METADATA yang ditentukan. Properti yang akan diambil diidentifikasi oleh parameter input WS_METADATA_PROPERTY_ID .

Catatan Data yang dikembalikan oleh fungsi ini valid hingga objek metadata dirilis atau direset. Data tidak boleh dimodifikasi.

Sintaks

HRESULT WsGetMetadataProperty(
  [in]           WS_METADATA             *metadata,
  [in]           WS_METADATA_PROPERTY_ID id,
                 void                    *value,
  [in]           ULONG                   valueSize,
  [in, optional] WS_ERROR                *error
);

Parameter

[in] metadata

Penunjuk ke objek Metadata yang berisi properti yang diinginkan. Parameter ini harus berupa objek WS_METADATA yang valid.

[in] id

Nilai pengidentifikasi properti yang akan diambil.

value

Referensi ke lokasi untuk menyimpan nilai properti yang diambil. Penunjuk harus memiliki perataan yang kompatibel dengan jenis properti.

[in] valueSize

Ukuran buffer panjang byte yang dialokasikan oleh pemanggil untuk menyimpan nilai properti yang diambil.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Id properti tidak didukung untuk objek ini atau buffer yang ditentukan tidak cukup besar untuk nilai tersebut.
E_OUTOFMEMORY	Kehabisan memori.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui