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

PropertyContext

PropertyContext 類別含有用以取得和設定內容的函數。這些函數可運作在可含有內容的任何物件上。

除了 ErrorBlockIteratorProperty 物件外, 所有物件都可含有內容。

函數

函數摘要:
函數 說明
xmsGetBooleanProperty 取得名稱所識別之 Boolean 內容的值。
xmsGetByteArrayProperty 取得名稱所識別之位元組陣列內容的值。
xmsGetByteArrayPropertyByRef 取得名稱所識別之位元組陣列內容值的指標。
xmsGetByteProperty 取得名稱所識別之位元組內容的值。
xmsGetCharProperty 取得名稱所識別之二位元組字元內容的值。
xmsGetDoubleProperty 取得名稱所識別之倍精準度浮點數內容的值。
xmsGetFloatProperty 取得名稱所識別之浮點數內容的值。
xmsGetHandleTypeId 取得物件的控點類型。
xmsGetIntProperty 取得名稱所識別之整數內容的值。
xmsGetLongProperty 取得名稱所識別之長整數內容的值。
xmsGetObjectProperty 取得名稱所識別之內容的值和資料類型。
xmsGetProperty 取得名稱所識別之內容的 Properties 物件。
xmsGetShortProperty 取得名稱所識別之短整數內容的值。
xmsGetStringProperty 取得名稱所識別之字串內容的值。
xmsGetStringPropertyByRef 取得名稱所識別之字串內容值的指標。
xmsSetBooleanProperty 設定名稱所識別之 Boolean 內容的值。
xmsSetByteProperty 設定名稱所識別之位元組內容的值。
xmsSetByteArrayProperty 設定名稱所識別之位元組陣列內容的值。
xmsSetCharProperty 設定名稱所識別之二位元組字元內容的值。
xmsSetDoubleProperty 設定名稱所識別之倍精準度浮點數內容的值。
xmsSetFloatProperty 設定名稱所識別之浮點數內容的值。
xmsSetIntProperty 設定名稱所識別之整數內容的值。
xmsSetLongProperty 設定名稱所識別之長整數內容的值。
xmsSetObjectProperty 設定名稱所識別之內容的值和資料類型。
xmsSetProperty 使用 Properties 物件來設定內容的值。
xmsSetShortProperty 設定名稱所識別之短整數內容的值。
xmsSetStringProperty 設定名稱所識別之字串內容的值。

xmsGetBooleanProperty – 取得 Boolean 內容

介面:
xmsRC xmsGetBooleanProperty(xmsHObj object,
                            xmsCHAR *propertyName,
                            xmsBOOL *propertyValue,
                            xmsHErrorBlock errorBlock);

取得名稱所識別之 Boolean 內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetByteArrayProperty – 取得位元組陣列內容

介面:
xmsRC xmsGetByteArrayProperty(xmsHObj object
                              xmsCHAR *propertyName,
                              xmsSBYTE *propertyValue,
                              xmsINT length,
                              xmsINT *actualLength
                              xmsHErrorBlock errorBlock) const;

取得名稱所識別之位元組陣列內容的值。

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

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內含內容值(為一個位元組陣列)的緩衝區。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回位元組陣列,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
陣列中的位元組數。如果您在輸入中指定一個空值指標, 則不會傳回陣列的長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetByteArrayPropertyByRef – 取得參照形式的位元組陣列內容

介面:
xmsRC xmsGetByteArrayPropertyByRef(xmsHObj object
                                   xmsCHAR *propertyName,
                                   xmsSBYTE **propertyValue,
                                   xmsINT *length,
                                   xmsHErrorBlock errorBlock) const;

取得名稱所識別之位元組陣列內容值的指標。

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

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值(為一個位元組陣列)的指標。
length(輸出)
陣列中的位元組數。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetByteProperty – 取得位元組內容

介面:
xmsRC xmsGetByteProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsSBYTE *propertyValue,
                         xmsHErrorBlock errorBlock);

取得名稱所識別之位元組內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetCharProperty – 取得字元內容

介面:
xmsRC xmsGetCharProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsCHAR16 *propertyValue,
                         xmsHErrorBlock errorBlock);

取得名稱所識別之二位元組字元內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetDoubleProperty – 取得倍精準度浮點數內容

介面:
xmsRC xmsGetDoubleProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsDOUBLE *propertyValue,
                           xmsHErrorBlock errorBlock);

取得名稱所識別之倍精準度浮點數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetFloatProperty – 取得浮點數內容

介面:
xmsRC xmsGetFloatProperty(xmsHObj object,
                          xmsCHAR *propertyName,
                          xmsFLOAT *propertyValue,
                          xmsHErrorBlock errorBlock);

取得名稱所識別之浮點數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetHandleTypeId – 取得控點類型

介面:
xmsRC xmsGetHandleTypeId(xmsHObj object,
                         xmsHANDLE_TYPE *handleType,
                         xmsHErrorBlock errorBlock);

取得物件的控點類型。

參數:
object(輸入)
物件的控點。
handleType(輸出)
物件的控點類型,其值為下列之一:
  • XMS_HANDLE_TYPE_CONN
  • XMS_HANDLE_TYPE_CONNFACT
  • XMS_HANDLE_TYPE_CONNMETADATA
  • XMS_HANDLE_TYPE_DEST
  • XMS_HANDLE_TYPE_ERRORBLOCK
  • XMS_HANDLE_TYPE_INITIALCONTEXT
  • XMS_HANDLE_TYPE_ITERATOR
  • XMS_HANDLE_TYPE_MSG
  • XMS_HANDLE_TYPE_MSGCONSUMER
  • XMS_HANDLE_TYPE_MSGPRODUCER
  • XMS_HANDLE_TYPE_QUEUEBROWSER
  • XMS_HANDLE_TYPE_PROPERTY
  • XMS_HANDLE_TYPE_REQUESTOR
  • XMS_HANDLE_TYPE_SESS
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetIntProperty – 取得整數內容

介面:
xmsRC xmsGetIntProperty(xmsHObj object,
                        xmsCHAR *propertyName,
                        xmsINT *propertyValue,
                        xmsHErrorBlock errorBlock);

取得名稱所識別之整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetLongProperty – 取得長整數內容

介面:
xmsRC xmsGetLongProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsLONG *propertyValue,
                         xmsHErrorBlock errorBlock);

取得名稱所識別之長整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetObjectProperty – 取得物件內容

介面:
xmsRC xmsGetObjectProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsSBYTE *propertyValue,
                           xmsINT length,
                           xmsINT *actualLength,
                           xmsOBJECT_TYPE *objectType,
                           xmsHErrorBlock errorBlock);

取得名稱所識別之內容的值和資料類型。

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

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內含內容值(以位元組陣列形式傳回)的緩衝區。如果值為一個字串而需要轉換資料, 則此為轉換後的值。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回內容的值,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
內容值的長度(以位元組計)。如果值為一個字串而需要轉換資料, 則此為轉換後的長度。如果您在輸入中指定一個空值指標, 則不會傳回長度。
objectType(輸出)
內容值的資料類型,可為下列一種物件類型:
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetProperty – 取得內容

介面:
xmsRC xmsGetProperty(xmsHObj object,
                     xmsCHAR *propertyName,
                     xmsHProperty *property,
                     xmsHErrorBlock errorBlock);

取得名稱所識別之內容的 Properties 物件。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
property(輸出)
Properties 物件的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetShortProperty – 取得短整數內容

介面:
xmsRC xmsGetShortProperty(xmsHObj object,
                          xmsCHAR *propertyName,
                          xmsLONG *propertyValue,
                          xmsHErrorBlock errorBlock);

取得名稱所識別之短整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetStringProperty – 取得字串內容

介面:
xmsRC xmsGetStringProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsCHAR *propertyValue,
                           xmsINT length,
                           xmsINT *actualLength,
                           xmsHErrorBlock errorBlock);

取得名稱所識別之字串內容的值。

如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內含內容值的緩衝區。如果需要轉換資料, 則此為轉換後的值。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回內容的值,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
內容值的長度(以位元組計)。如果需要轉換資料, 則此為轉換後的長度。如果您在輸入中指定一個空值指標, 則不會傳回長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsGetStringPropertyByRef – 取得參照形式的字串內容

介面:
xmsRC xmsMsgGetStringPropertyByRef(xmsHObj object,
                                   xmsCHAR *propertyName,
                                   xmsCHAR **propertyValue,
                                   xmsINT *length,
                                   xmsHErrorBlock errorBlock);

取得名稱所識別之字串內容值的指標。

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

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸出)
內容值的指標。如果需要轉換資料, 則此為轉換後的值。

請注意,內容值必須是一個字串。函數不會試著將另一種資料類型的值轉換成字串。如果應用程式呼叫此函數以取得非字串值的指標, 則 XMS 會傳回 XMS_E_TYPE_CONVERSION_FAILED 錯誤碼。

length(輸出)
內容值的長度(以位元組計)。如果需要轉換資料, 則此為轉換後的長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsSetBooleanProperty – 設定 Boolean 內容

介面:
xmsRC xmsSetBooleanProperty(xmsHObj object,
                            xmsCHAR *propertyName,
                            xmsBOOL propertyValue,
                            xmsHErrorBlock errorBlock);

設定名稱所識別之 Boolean 內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetByteProperty – 設定位元組內容

介面:
xmsRC xmsSetByteProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsSBYTE propertyValue,
                         xmsHErrorBlock errorBlock);

設定名稱所識別之位元組內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetByteArrayProperty – 設定位元組陣列內容

介面:
xmsRC xmsSetByteArrayProperty(xmsHObj object,
                              xmsCHAR *propertyName,
                              xmsSBYTE *propertyValue,
                              xmsINT length
                              xmsHErrorBlock errorBlock);

設定名稱所識別之位元組陣列內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容的值,為一個位元組陣列。
length(輸入)
陣列中的位元組數。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetCharProperty – 設定字元內容

介面:
xmsRC xmsSetCharProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsCHAR16 propertyValue,
                         xmsHErrorBlock errorBlock);

設定名稱所識別之二位元組字元內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetDoubleProperty – 設定倍精準度浮點數內容

介面:
xmsRC xmsSetDoubleProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsDOUBLE propertyValue,
                           xmsHErrorBlock errorBlock);

設定名稱所識別之倍精準度浮點數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetFloatProperty – 設定浮點數內容

介面:
xmsRC xmsSetFloatProperty(xmsHObj object,
                          xmsCHAR *propertyName,
                          xmsFLOAT propertyValue,
                          xmsHErrorBlock errorBlock);

設定名稱所識別之浮點數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetIntProperty – 設定整數內容

介面:
xmsRC xmsSetIntProperty(xmsHObj object,
                        xmsCHAR *propertyName,
                        xmsINT propertyValue,
                        xmsHErrorBlock errorBlock);

設定名稱所識別之整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetLongProperty – 設定長整數內容

介面:
xmsRC xmsSetLongProperty(xmsHObj object,
                         xmsCHAR *propertyName,
                         xmsLONG propertyValue,
                         xmsHErrorBlock errorBlock);

設定名稱所識別之長整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetObjectProperty – 設定物件內容

介面:
xmsRC xmsSetObjectProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsSBYTE *propertyValue,
                           xmsINT length,
                           xmsOBJECT_TYPE objectType,
                           xmsHErrorBlock errorBlock);

設定名稱所識別之內容的值和資料類型。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
位元組陣列形式的內容值。
length(輸入)
陣列中的位元組數。
objectType(輸入)
內容值的資料類型,必須是下列一種物件類型:
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetProperty – 設定內容

介面:
xmsRC xmsSetProperty(xmsHObj object,
                     xmsHProperty property,
                     xmsHErrorBlock errorBlock);

使用 Properties 物件來設定內容的值。

參數:
object(輸入)
物件的控點。
property(輸入)
Properties 物件的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetShortProperty – 設定短整數內容

介面:
xmsRC xmsSetShortProperty(xmsHObj object,
                          xmsCHAR *propertyName,
                          xmsSHORT propertyValue,
                          xmsHErrorBlock errorBlock);

設定名稱所識別之短整數內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
內容值。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
由物件的執行緒環境定義決定
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

xmsSetStringProperty – 設定字串內容

介面:
xmsRC xmsSetStringProperty(xmsHObj object,
                           xmsCHAR *propertyName,
                           xmsCHAR *propertyValue,
                           xmsINT length,
                           xmsHErrorBlock errorBlock);

設定名稱所識別之字串內容的值。

參數:
object(輸入)
物件的控點。
propertyName(輸入)
採空值終止字串格式的內容名稱。
propertyValue(輸入)
字元陣列形式的內容值。
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)