WsGetHeaderAttributes 函式 (webservices.h)

  • 發行項

此函式會填入ULONG參數，其中包含讀取器所在標頭專案的 WS_HEADER_ATTRIBUTES 。 訊息的信封版本是用來判斷要傳回的屬性。

語法

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

參數

[in] message

包含要查詢之訊息 之WS_MESSAGE 結構的指標。 此信封版本的訊息是用來判斷哪些屬性相符。 訊息可以處於任何狀態，但 WS_MESSAGE_STATE_EMPTY除外。

[in] reader

要查詢之讀取器的指標。 這必須是從 WsCreateReader 傳回且不可為 NULL 的有效WS_XML_READER物件。

[out] headerAttributes

成功時，這個指標所參考的值會設定為標頭屬性。

[in, optional] error

WS_ERROR 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

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

傳回碼 Description
E_OUTOFMEMORY
 記憶體不足。
E_INVALIDARG
 一或多個引數無效。
WS_E_INVALID_FORMAT
 輸入數據的格式不正確，或沒有預期的值。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

系統會假設讀取器指向標頭專案。 使用 XML 讀取器 API 來適當地定位讀取器。

規格需求

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