函數 | 說明 |
---|---|
xmsBytesMsgGetBodyLength | 在訊息主體為唯讀時,取得訊息主體的長度。 |
xmsBytesMsgReadBoolean | 從位元組訊息串流中讀取 Boolean 值。 |
xmsBytesMsgReadByte | 從位元組訊息串流中讀取下一個位元組, 以當成一個帶正負號的 8 位元整數。 |
xmsBytesMsgReadBytes | 在位元組訊息串流中,從游標的現行位置開始讀取位元組陣列。 |
xmsBytesMsgReadBytesByRef | 取得指向位元組訊息串流開頭的指標,以及取得字串的長度。 |
xmsBytesMsgReadChar | 從位元組訊息串流中讀取下兩個位元組,以當成一個字元。 |
xmsBytesMsgReadDouble | 從位元組訊息串流中讀取下 8 個位元組, 以當成一個倍精準度浮點數。 |
xmsBytesMsgReadFloat | 從位元組訊息串流中讀取下 4 個位元組, 以當成一個浮點數。 |
xmsBytesMsgReadInt | 從位元組訊息串流中讀取下 4 個位元組, 以當成一個帶正負號的 32 位元整數。 |
xmsBytesMsgReadLong | 從位元組訊息串流中讀取下 8 個位元組, 以當成一個帶正負號的 64 位元整數。 |
xmsBytesMsgReadShort | 從位元組訊息串流中讀取下 2 個位元組, 以當成一個帶正負號的 16 位元整數。 |
xmsBytesMsgReadUnsignedByte | 從位元組訊息串流中讀取下一個位元組, 以當成一個不帶正負號的 8 位元整數。 |
xmsBytesMsgReadUnsignedShort | 從位元組訊息串流中讀取下 2 個位元組, 以當成一個不帶正負號的 16 位元整數。 |
xmsBytesMsgReadUTF | 從位元組訊息串流讀取一個以 UTF-8 編碼的字串。 |
xmsBytesMsgReset | 將訊息主體變成唯讀模式, 並將游標重新定位在位元組訊息串流開頭。 |
xmsBytesMsgWriteBoolean | 將 Boolean 值寫入位元組訊息串流中。 |
xmsBytesMsgWriteByte | 將位元組寫入位元組訊息串流中。 |
xmsBytesMsgWriteBytes | 將位元組陣列寫入位元組訊息串流中。 |
xmsBytesMsgWriteChar | 將字元當成 2 位元組寫入位元組訊息串流中, 並從次序高的位元組開始。 |
xmsBytesMsgWriteDouble | 將倍精準度浮點數轉換成長整數, 並將長整數當成 8 位元組寫入位元組訊息串流中,且從次序高的位元組開始。 |
xmsBytesMsgWriteFloat | 將浮點數轉換成整數, 並將整數當成 4 位元組寫入位元組訊息串流中,且從次序高的位元組開始。 |
xmsBytesMsgWriteInt | 將整數當成 4 位元組寫入位元組訊息串流中, 並從次序高的位元組開始。 |
xmsBytesMsgWriteLong | 將長整數當成 8 位元組寫入位元組訊息串流中, 並從次序高的位元組開始。 |
xmsBytesMsgWriteShort | 將短整數當成 2 位元組寫入位元組訊息串流中, 並從次序高的位元組開始。 |
xmsBytesMsgWriteUTF | 將以 UTF-8 編碼的字串寫入位元組訊息串流中。 |
xmsRC xmsBytesMsgGetBodyLength(xmsHMsg message, xmsLONG *bodyLength, xmsHErrorBlock errorBlock);
xmsRC xmsBytesMsgReadBoolean(xmsHMsg message, xmsBOOL *value, xmsHErrorBlock errorBlock);
xmsRC xmsBytesMsgReadByte(xmsHMsg message, xmsSBYTE *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下一個位元組, 以當成一個帶正負號的 8 位元整數。
xmsRC xmsBytesMsgReadBytes(xmsHMsg message, xmsSBYTE *buffer, xmsINT bufferLength, xmsINT *returnedLength, xmsHErrorBlock errorBlock);
如果您在輸入中指定一個空值指標, 則函數會略過位元組而不會讀取。如果在呼叫前,要從串流中讀取的剩餘位元組數, 大於或等於緩衝區的長度,則所略過的位元組數等於緩衝區長度。否則,會略過所有剩餘的位元組。
如果您在輸入中指定一個空值指標, 則函數不會傳回任何值。
xmsRC xmsBytesMsgReadBytesByRef(xmsHMsg message, xmsSBYTE **stream, xmsINT *length, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以參照形式來傳回字串或位元組陣列的 C 函數。
xmsRC xmsBytesMsgReadChar(xmsHMsg message, xmsCHAR16 *value, xmsHErrorBlock errorBlock);
xmsRC xmsBytesMsgReadDouble(xmsHMsg message, xmsDOUBLE *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 8 個位元組, 以當成一個倍精準度浮點數。
xmsRC xmsBytesMsgReadFloat(xmsHMsg message, xmsFLOAT *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 4 個位元組, 以當成一個浮點數。
xmsRC xmsBytesMsgReadInt(xmsHMsg message, xmsINT *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 4 個位元組, 以當成一個帶正負號的 32 位元整數。
xmsRC xmsBytesMsgReadLong(xmsHMsg message, xmsLONG *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 8 個位元組, 以當成一個帶正負號的 64 位元整數。
xmsRC xmsBytesMsgReadShort(xmsHMsg message, xmsSHORT *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 2 個位元組, 以當成一個帶正負號的 16 位元整數。
xmsRC xmsBytesMsgReadUnsignedByte(xmsHMsg message, xmsBYTE *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下一個位元組, 以當成一個不帶正負號的 8 位元整數。
xmsRC xmsBytesMsgReadUnsignedShort(xmsHMsg message, xmsUSHORT *value, xmsHErrorBlock errorBlock);
從位元組訊息串流中讀取下 2 個位元組, 以當成一個不帶正負號的 16 位元整數。
xmsRC xmsBytesMsgReadUTF(xmsHMsg message, xmsCHAR *buffer, xmsINT bufferLength, xmsINT *actualLength, xmsHErrorBlock errorBlock);
從位元組訊息串流讀取一個以 UTF-8 編碼的字串。 必要時, XMS 會將字串中的字元從 UTF-8 轉換成區域字碼頁。
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。
如果您指定 XMSC_QUERY_SIZE, 則不會傳回字串,而會將其長度放在 actualLength 參數中傳回,且游標不會前進。
如果您指定 XMSC_SKIP, 則函數會略過該字串而不會讀取。
xmsRC xmsBytesMsgWriteUTF(xmsHMsg message, xmsCHAR *value, xmsINT length, xmsHErrorBlock errorBlock);
將以 UTF-8 編碼的字串寫入位元組訊息串流中。 必要時,XMS 會將字串中的字元從區域字碼頁轉換成 UTF-8。