MI_Serializer_SerializeInstance函式 (mi.h)

以串行化程式建立時所指定的格式，將 MI_Instance 串行化為緩衝區。 選項可以傳遞至旗標，以控制類別是否也串行化至緩衝區和 實例。

語法

MI_INLINE MI_Result MI_Serializer_SerializeInstance(
  [in, out] MI_Serializer     *serializer,
            MI_Uint32         flags,
  [in]      const MI_Instance *instanceObject,
            MI_Uint8          *clientBuffer,
            MI_Uint32         clientBufferLength,
  [in, out] MI_Uint32         *clientBufferNeeded
);

參數

[in, out] serializer

從 MI_Application_NewSerializer傳回的串行化程式。

flags

必須是 0 或 MI_SERIALIZER_FLAGS_INSTANCE_WITH_CLASS。 0 表示只串行化實例。 MI_SERIALIZER_FLAGS_INSTANCE_WITH_CLASS 表示將實例和所有類別元件串行化為緩衝區，使其獨立。

[in] instanceObject

要串行化的實例物件。

clientBuffer

要接收串行化類別數據的輸出緩衝區。 如果此參數為 Null，則會在 clientBufferNeeded 中傳回緩衝區的必要長度。

clientBufferLength

傳入的 clientBuffer 長度。 如果 clientBuffer 為 Null，此參數應為 0。

[in, out] clientBufferNeeded

緩衝區需要的總長度傳回。 如果緩衝區是透過 clientBuffer 參數傳入 (，) 為所需的大小或更多大小，這個值會指出使用了多少緩衝區。 如果緩衝區未傳入 (其中 clientBuffer 值為 Null) ，或緩衝區太小而無法保存串行化類別，這個值會指出需要多少空間來保存串行化類別。

傳回值

指定函式傳回碼的 MI_Result 列舉值。 這可以是下列其中一個程序代碼。

規格需求

另請參閱

MI_Application_NewSerializer