共用方式為

WsFindAttribute 函式 (webservices.h)

  • 發行項

在目前元素的屬性中搜尋具有指定名稱和命名空間的屬性，並傳回其可能傳遞至 WsReadStartAttribute 的索引。

語法

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
);

參數

[in] reader

要在其中尋找屬性的讀取器。

[in] localName

要搜尋的屬性本機名稱。

[in] ns

要搜尋的屬性命名空間。

[in] required

如果必要為 TRUE ，且找不到屬性，函式會傳回 WS_E_INVALID_FORMAT。 (如果必要為 FALSE 且找不到屬性，請參閱 Windows Web 服務傳回 Values.) ，函式會傳回S_FALSE。

[out] attributeIndex

如果找到屬性，則會在這裡傳回屬性的索引。 此索引接著可以傳遞至 WsReadStartAttribute。

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據的格式不正確，或沒有預期的值。

備註

如果讀取器不在起始元素上，則會傳回 WS_E_INVALID_OPERATION。 (請參閱 Windows Web 服務傳回值。)

傳回的索引不一定對應至屬性出現在檔中的位置。 它會識別 WS_XML_ELEMENT_NODE之屬性數位中相符屬性的索引。 此陣列中屬性的順序可能與屬性出現在檔中的順序不同。

規格需求

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