WsGetXmlAttribute 函式 (webservices.h)

  • 發行項

使用指定的localName在範圍中尋找最接近的 xml 屬性，並傳回其值。
傳回的值會放在指定的堆積上。

語法

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

參數

[in] reader

要搜尋 xml 屬性的讀取器。

[in] localName

要搜尋之 xml 屬性的localName。

[in] heap

應該配置結果值的堆積。

valueChars

屬性的值會儲存在這裡。

[out] valueCharCount

valueChars 的長度。

[in, optional] error

指定函式失敗時應該儲存其他錯誤資訊的位置。

傳回值

此函式可以傳回其中一個值。

傳回碼 Description
E_INVALIDARG
 一或多個引數無效。
S_FALSE
 找不到 xml 屬性。

備註

此函式只能用來取得範圍中使用前置詞 「xml」 的屬性值。

如果找不到相符的 xml 屬性，則會針對值傳回零長度字串，而且函式會傳回S_FALSE。

讀取器不會對 xml 屬性執行任何動作，而不是以表面呈現以進行檢查。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll