WsMarkHeaderAsUnderstood 函式 (webservices.h)

  • 發行項

此函式會將標頭標示為應用程式「瞭解」。

一組標頭是可延伸的，而且傳送者無法存取接收者的 Message assimilation。 此函式是接收的應用程式方法，可讓傳送者知道已讀取並瞭解接收的標頭。

注意 只有當應用程式收到訊息，指出必須了解標頭，且未使用 WsGetHeader 或 WsGetCustomHeader 取得標頭時，才應該使用此函式。

WS_MESSAGE_STATE必須設定為 WS_MESSAGE_STATE_READING。 看到。如需詳細資訊，請參閱 WsCheckMustUnderstandHeaders 。

 

語法

HRESULT WsMarkHeaderAsUnderstood(
  [in]           WS_MESSAGE                 *message,
  [in]           const WS_XML_NODE_POSITION *headerPosition,
  [in, optional] WS_ERROR                   *error
);

參數

[in] message

具有要標記之標頭之 Message 物件的指標。

[in] headerPosition

XML 標頭區段內標頭專案位置的指標。

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_OPERATION
 訊息未處於正確的狀態。
E_INVALIDARG
 一或多個引數無效。
E_OUTOFMEMORY
 記憶體不足。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

當應用程式使用 XML 讀取器讀取標頭時，它應該取得標頭專案的 WS_XML_NODE_POSITION ，並將它傳遞至此函式。 如需如何取得WS_XML_NODE_POSITION，請參閱 WsGetReaderPosition。

規格需求

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