Fungsi WsFindAttribute (webservices.h)

Artikel
08/27/2023

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
WS_E_INVALID_FORMAT	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

Bagikan melalui