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

ObjectMessage

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

相關參考
物件訊息

函數

函數摘要:
函數 說明
xmsObjectMsgGetObjectAsBytes 取得構成物件訊息主體的物件。
xmsObjectMsgSetObjectAsBytes 設定構成物件訊息主體的物件。

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

介面:
xmsRC xmsObjectMsgGetObjectAsBytes(xmsHMsg message,
                                   xmsSBYTE *buffer,
                                   xmsINT bufferLength,
                                   xmsINT *actualLength,
                                   xmsHErrorBlock errorBlock);

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

如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回位元組陣列的 C 函數

參數:
message(輸入)
訊息的控點。
buffer(輸出)
內含物件(以位元組陣列形式傳回)的緩衝區。
bufferLength(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回物件,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
物件的長度(以位元組計)。如果您在輸入中指定一個空值指標, 則不會傳回長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • 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 參數。

xmsObjectMsgSetObjectAsBytes – 將物件設為位元組

介面:
xmsRC xmsObjectMsgSetObjectAsBytes(xmsHMsg message,
                                   xmsSBYTE *value,
                                   xmsINT length,
                                   xmsHErrorBlock errorBlock);

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

參數:
message(輸入)
訊息的控點。
value(輸入)
代表所要設定之物件的位元組陣列。
length(輸入)
陣列中的位元組數。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • 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)