WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

ObjectMessage

物件訊息是一種其主體包含一個已序列化的 Java 或 .NET 物件的訊息。

繼承階層:
xms::PropertyContext
   |
   +----xms::Message
           |
           +----xms::ObjectMessage
相關參考
物件訊息

方法

方法摘要:
方法 說明
getObject 取得構成物件訊息主體的物件。
setObject 設定構成物件訊息主體的字串。

getObject – 以位元組形式取得物件

介面:
xmsINT getObject(xmsSBYTE *buffer,
                 xmsINT bufferLength,
                 xmsINT *actualLength);

取得構成物件訊息主體的物件。

有關此方法用法的詳細資訊, 請參閱會傳回位元組陣列的 C++ 方法

參數:
buffer(輸出)
內含物件(以位元組陣列形式傳回)的緩衝區。
bufferLength(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回物件,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
物件的長度(以位元組計)。如果您在輸入中指定一個空值指標, 則不會傳回長度。
傳回:
物件的長度(以位元組計)。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION
附註:
  1. 如果緩衝區不夠儲存整個物件,XMS 會傳回截斷成符合緩衝區長度的物件, 以及將 actualLength 參數設為物件的實際長度,並傳回 XMS_E_DATA_TRUNCATED 錯誤碼。
  2. 如果在試著取得物件期間發生其他任何錯誤, XMS 會報告錯誤,但不會設定 actualLength 參數。

setObject – 將物件設為位元組

介面:
xmsVOID setObject(xmsSBYTE *value,
                  xmsINT length);

設定構成物件訊息主體的字串。

參數:
value(輸入)
代表所要設定之物件的位元組陣列。
length(輸入)
陣列中的位元組數。
傳回:
Void
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

繼承的方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)