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

文字訊息

文字訊息是一種其主體包含一個字串的訊息。

相關參考
文字訊息

函數

函數摘要:
函數 說明
xmsTextMsgGetText 取得構成文字訊息主體的字串。
xmsTextMsgSetText 設定構成文字訊息主體的字串。

xmsTextMsgGetText – 取得文字

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

取得構成文字訊息主體的字串。必要時, XMS 會將字串中的字元轉換成區域字碼頁。

如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 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 參數。

xmsTextMsgSetText – 設定文字

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

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

參數:
message(輸入)
訊息的控點。
value(輸入)
內含所要設定之字串的字元陣列。
length(輸入)
字串的長度(以位元組計)。如果字串在沒有內嵌空值字元下空值終止, 您可以指定 XMSC_CALCULATE_STRING_SIZE,以容許 XMS 計算其長度。
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)