Fungsi WsGetReaderNode (webservices.h)

Artikel
03/03/2024

Fungsi mengembalikan simpul XML pada posisi pembaca XML saat ini.

Sintaks

HRESULT WsGetReaderNode(
  [in]           WS_XML_READER     *xmlReader,
                 const WS_XML_NODE **node,
  [in, optional] WS_ERROR          *error
);

Parameter

[in] xmlReader

Penunjuk ke pembaca di mana simpul saat ini akan diperoleh. Ini harus berupa objek WS_XML_READER yang valid.

node

Referensi ke struktur WS_XML_NODE tempat simpul saat ini dikembalikan.

[in, optional] error

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

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

Bidang nodeType dari node node harus diperiksa untuk menentukan jenis node yang dikembalikan. Simpul kemudian dapat dilemparkan ke struktur data yang sesuai untuk mendapatkan data.

WS_XML_NODE* node;
if (SUCCEEDED(WsGetReaderNode(reader, &node, error)))
{
    if (node->nodeType == WS_XML_NODE_TYPE_ELEMENT)
    {
        WS_XML_ELEMENT_NODE* elementNode = (WS_XML_ELEMENT_NODE*) node;
        // Refer to elementNode->localName, elementNode->ns
    }
}

NodeTypes dengan struktur yang diperluas meliputi:

WS_XML_NODE_TYPE_ELEMENT =>WS_XML_ELEMENT_NODE
WS_XML_NODE_TYPE_TEXT =>WS_XML_TEXT_NODE
WS_XML_NODE_TYPE_COMMENT =>WS_XML_COMMENT_NODE

Simpul yang dikembalikan tidak boleh dimodifikasi dan hanya valid sampai pembaca maju. Untuk atribut dalam penelepon WS_XML_ELEMENT_NODE seharusnya tidak mengharapkan atribut muncul dalam urutan tertentu.

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