- 介面:
-
xmsINT getObject(xmsSBYTE *buffer,
xmsINT bufferLength,
xmsINT *actualLength);
取得構成物件訊息主體的物件。
有關此方法用法的詳細資訊,
請參閱會傳回位元組陣列的 C++ 方法。
- 參數:
- buffer(輸出)
- 內含物件(以位元組陣列形式傳回)的緩衝區。
- bufferLength(輸入)
- 緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE,
則不會傳回物件,而會將其長度放在 actualLength 參數中傳回。
- actualLength(輸出)
- 物件的長度(以位元組計)。如果您在輸入中指定一個空值指標,
則不會傳回長度。
- 傳回:
- 物件的長度(以位元組計)。
- 異常狀況:
-
- XMS_X_GENERAL_EXCEPTION
- XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
- XMS_X_MESSAGE_EOF_EXCEPTION
附註: - 如果緩衝區不夠儲存整個物件,XMS 會傳回截斷成符合緩衝區長度的物件,
以及將 actualLength 參數設為物件的實際長度,並傳回 XMS_E_DATA_TRUNCATED 錯誤碼。
- 如果在試著取得物件期間發生其他任何錯誤,
XMS 會報告錯誤,但不會設定 actualLength 參數。