共用方式為

WsCall 函式 (webservices.h)

  • 發行項

服務 Proxy 在內部使用，根據指定的元數據格式化指定的自變數，並在訊息中傳送這些自變數。 應用程式不應該直接呼叫此函式。

語法

HRESULT WsCall(
  [in]           WS_SERVICE_PROXY               *serviceProxy,
  [in]           const WS_OPERATION_DESCRIPTION *operation,
  [in, optional] const void                     **arguments,
  [in]           WS_HEAP                        *heap,
                 const WS_CALL_PROPERTY         *callProperties,
  [in]           const ULONG                    callPropertyCount,
  [in, optional] const WS_ASYNC_CONTEXT         *asyncContext,
  [in, optional] WS_ERROR                       *error
);

參數

[in] serviceProxy

表示服務 Proxy 之WS_SERVICE_PROXY結構的指標。

[in] operation

包含呼叫元數據 之WS_OPERATION_DESCRIPTION 結構的指標。

[in, optional] arguments

作業 參數所 表示之服務作業之個別自變數的指標陣列。

元素數目必須對應至作業參數中指定為WS_OPERATION_DESCRIPTION一部分的參數數目。

[in] heap

WS_HEAP 結構的指標，表示為呼叫配置記憶體的堆積。

callProperties

包含呼叫屬性 的WS_CALL_PROPERTY 結構的陣列。

[in] callPropertyCount

呼叫屬性陣列中的屬性數目。

[in, optional] asyncContext

以異步方式叫用函式之資訊的指標。 傳遞 NULL 以同步叫用函式。

[in, optional] error

如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。

傳回碼 Description
WS_E_INVALID_OPERATION
 由於物件的目前狀態，不允許此作業。
WS_E_QUOTA_EXCEEDED
 超過配額。
WS_E_OPERATION_ABANDONED
 作業已放棄。
WS_E_OPERATION_TIMED_OUT
 作業未在配置的時間內完成。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
E_INVALIDARG
 一或多個引數無效。
WS_S_ASYNC
 異步操作仍在擱置中。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

規格需求

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