對映訊息是一種其主體包含一組名稱值組(其中每一個值都有一個相關聯的資料類型)的訊息。
當應用程式取得名稱值組的值時,該值可由 XMS 轉換成另一種資料類型。如需這種隱含轉換形式的相關資訊,請參閱對映訊息。
函數 | 說明 |
---|---|
xmsMapMsgGetBoolean | 從對映訊息主體中取得名稱所識別的 Boolean 值。 |
xmsMapMsgGetByte | 從對映訊息主體中取得名稱所識別的位元組。 |
xmsMapMsgGetBytes | 從對映訊息主體中取得名稱所識別的位元組陣列。 |
xmsMapMsgGetBytesByRef | 取得對映訊息主體中之位元組陣列的指標, 並取得陣列的長度。 |
xmsMapMsgGetChar | 從對映訊息主體中取得名稱所識別的字元。 |
xmsMapMsgGetDouble | 從對映訊息主體中取得名稱所識別的倍精準度浮點數。 |
xmsMapMsgGetFloat | 從對映訊息主體中取得名稱所識別的浮點數。 |
xmsMapMsgGetInt | 從對映訊息主體中取得名稱所識別的整數。 |
xmsMapMsgGetLong | 從對映訊息主體中取得名稱所識別的長整數。 |
xmsMapMsgGetMap | 取得對映訊息主體中的名稱值組清單。 |
xmsMapMsgGetObject | 從對映訊息主體中取得名稱值組的值與其資料類型。 |
xmsMapMsgGetShort | 從對映訊息主體中取得名稱所識別的短整數。 |
xmsMapMsgGetString | 從對映訊息主體中取得名稱所識別的字串。 |
xmsMapMsgGetStringByRef | 取得指向名稱所識別之字串的指標,以及取得字串的長度。 |
xmsMapMsgItemExists | 檢查對映訊息主體是否含有指定名稱的名稱值組。 |
xmsMapMsgSetBoolean | 在對映訊息主體中設定一個 Boolean 值。 |
xmsMapMsgSetByte | 在對映訊息主體中設定一個位元組。 |
xmsMapMsgSetBytes | 在對映訊息主體中設定一個位元組陣列。 |
xmsMapMsgSetChar | 在對映訊息主體中設定一個二位元組字元。 |
xmsMapMsgSetDouble | 在對映訊息主體中設定一個倍精準度浮點數。 |
xmsMapMsgSetFloat | 在對映訊息主體中設定一個浮點數。 |
xmsMapMsgSetInt | 在對映訊息主體中設定一個整數。 |
xmsMapMsgSetLong | 在對映訊息主體中設定一個長整數。 |
xmsMapMsgSetObject | 在對映訊息主體中設定一個採用指定資料類型的值。 |
xmsMapMsgSetShort | 在對映訊息主體中設定一個短整數。 |
xmsMapMsgSetString | 在對映訊息主體中設定一個字串。 |
xmsRC xmsMapMsgGetBytes(xmsHMsg message, xmsCHAR *name, xmsSBYTE *buffer, xmsINT bufferLength, xmsINT *actualLength, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回位元組陣列的 C 函數。
xmsRC xmsMapMsgGetBytesByRef(xmsHMsg message, xmsCHAR *name, xmsSBYTE **array, xmsINT *length, xmsHErrorBlock errorBlock);
取得對映訊息主體中之位元組陣列的指標, 並取得陣列的長度。位元組陣列是以名稱來識別。
如需如何使用此函數的相關資訊, 請參閱會以參照形式來傳回字串或位元組陣列的 C 函數。
xmsRC xmsMapMsgGetMap(xmsHMsg message, xmsHIterator *iterator, xmsHErrorBlock errorBlock);
此函數會傳回一個封裝 Properties 物件清單的疊代子, 其中,每一個 Properties 物件各封裝一個名稱值組。如此一來, 應用程式可使用疊代子依序存取每一個名稱值組。
xmsRC xmsMapMsgGetObject(xmsHMsg message, xmsCHAR *name, xmsSBYTE *buffer, xmsINT bufferLength, xmsINT *actualLength, xmsOBJECT_TYPE *objectType, xmsHErrorBlock errorBlock);
從對映訊息主體中取得名稱值組的值與其資料類型。名稱值組是以名稱來識別。
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回位元組陣列的 C 函數。
xmsRC xmsMapMsgGetString(xmsHMsg message, xmsCHAR *name, xmsCHAR *buffer, xmsINT bufferLength, xmsINT *actualLength, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。
xmsRC xmsMapMsgGetStringByRef(xmsHMsg message, xmsCHAR *name, xmsCHAR **string, xmsINT *length, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以參照形式來傳回字串或位元組陣列的 C 函數。
xmsRC xmsMapMsgItemExists(xmsHMsg message, xmsCHAR *name, xmsBOOL *pairExists, xmsHErrorBlock errorBlock);
xmsRC xmsMapMsgSetBytes(xmsHMsg message, xmsCHAR *name, xmsSBYTE *value, xmsINT length, xmsHErrorBlock errorBlock);
xmsRC xmsMapMsgSetObject(xmsHMsg message, xmsCHAR *name, xmsSBYTE *value, xmsINT length, xmsOBJECT_TYPE objectType, xmsHErrorBlock errorBlock);
xmsRC xmsMapMsgSetString(xmsHMsg message, xmsCHAR *name, xmsCHAR *value, xmsINT length, xmsHErrorBlock errorBlock);