WsReadEndpointAddressExtension 函式 (webservices.h)

讀取 WS_ENDPOINT_ADDRESS的延伸模組。

語法

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

參數

[in] reader

用來讀取延伸模組的 XML 讀取器。

函式會視需要自動設定讀取器的輸入，以讀取延伸模組。

[in] endpointAddress

包含延伸模組的端點位址。

[in] extensionType

要讀取的延伸模組類型。

[in] readOption

值是否為必要專案，以及如何配置值。 如需詳細資訊 ，請參閱WS_READ_OPTION 。

此參數必須具有下列其中一個值：

• WS_READ_REQUIRED_VALUE。
• WS_READ_REQUIRED_POINTER。
• WS_READ_OPTIONAL_POINTER。

[in] heap

用來儲存讀取值的堆積。

value

要放置讀取值之緩衝區的位址。

如果使用 readOption 參數 的WS_READ_REQUIRED_VALUE ，則緩衝區必須是讀取 (類型的大小，依 WS_ENDPOINT_ADDRESS_EXTENSION_TYPE) 而有所不同。

如果使用 WS_READ_REQUIRED_POINTER 或 WS_READ_OPTIONAL_POINTER，緩衝區應該是指標的大小。

[in] valueSize

呼叫端為讀取值所配置的緩衝區大小。

此大小應對應至使用 value 參數傳遞的緩衝區大小。

[in, optional] error

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

傳回值

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

傳回碼	Description
E_INVALIDARG	延伸模組類型無效。 提供緩衝區的大小不正確。 必要的參數為 NULL。
WS_E_INVALID_FORMAT	輸入數據的格式不正確，或沒有預期的值。
E_OUTOFMEMORY	記憶體不足。
其他錯誤	此函式可能會傳回上述未列出的其他錯誤。

備註

傳回的值有效，直到堆積釋放或重設為止。

如果要求的延伸模組類型在延伸模組緩衝區中出現一次以上，則會傳回第一個實例。

規格需求

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