Fungsi WsFindAttribute (webservices.h)
Mencari atribut elemen saat ini untuk atribut dengan nama dan namespace yang ditentukan dan mengembalikan indeksnya yang dapat diteruskan ke WsReadStartAttribute.
Sintaks
HRESULT WsFindAttribute(
[in] WS_XML_READER *reader,
[in] const WS_XML_STRING *localName,
[in] const WS_XML_STRING *ns,
[in] BOOL required,
[out] ULONG *attributeIndex,
[in, optional] WS_ERROR *error
);
Parameter
[in] reader
Pembaca untuk menemukan atribut .
[in] localName
Nama lokal atribut yang akan dicari.
[in] ns
Namespace atribut yang akan dicari.
[in] required
Jika diperlukan adalah TRUE dan atribut tidak ditemukan, fungsi akan mengembalikan WS_E_INVALID_FORMAT. (Lihat Nilai Pengembalian Windows Web Services.) jika diperlukan adalah FALSE dan atribut tidak ditemukan, fungsi akan mengembalikan S_FALSE.
[out] attributeIndex
Jika atribut ditemukan, maka indeks atribut , dikembalikan di sini. Indeks ini kemudian dapat diteruskan ke WsReadStartAttribute.
[in, optional] error
Menentukan tempat informasi kesalahan tambahan harus disimpan jika fungsi gagal.
Mengembalikan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
Keterangan
Jika pembaca tidak diposisikan pada elemen mulai, pembaca akan mengembalikan WS_E_INVALID_OPERATION. (Lihat Nilai Pengembalian Windows Web Services.)
Indeks yang dikembalikan tidak selalu sesuai dengan posisi atribut seperti yang muncul dalam dokumen. Ini mengidentifikasi indeks atribut yang cocok dalam array atribut WS_XML_ELEMENT_NODE. Urutan atribut dalam array ini mungkin berbeda dari urutan munculnya atribut dalam dokumen.
Persyaratan
Persyaratan | Nilai |
---|---|
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 |