Metode ISyncChangeBatchBase2::SerializeWithOptions (winsync.h)

Menserialisasikan data objek batch perubahan ke array byte, berdasarkan opsi versi dan serialisasi yang ditentukan.

Sintaks

HRESULT SerializeWithOptions(
  [in]      SYNC_SERIALIZATION_VERSION targetFormatVersion,
  [in]      DWORD                      dwFlags,
  [in, out] BYTE                       *pbBuffer,
  [in, out] DWORD                      *pdwSerializedSize
);

Parameter

[in] targetFormatVersion

Batch perubahan serial kompatibel dengan versi ini.

[in] dwFlags

Dicadangkan. Harus nol.

[in, out] pbBuffer

Data objek batch perubahan berseri diserialisasikan ke buffer ini.

[in, out] pdwSerializedSize

Jumlah byte dalam pbBuffer. Mengembalikan jumlah byte yang diperlukan untuk membuat serialisasi data batch perubahan saat pbBuffer terlalu kecil, atau jumlah byte yang ditulis.

Mengembalikan nilai

Kode pengembalian yang mungkin termasuk, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	dwFlags bukan nol, atau versi yang ditentukan oleh targetFormatVersion tidak kompatibel dengan data objek batch perubahan.
E_OUTOFMEMORY
E_POINTER	Penunjuk tidak valid.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)	pBuffer terlalu kecil. Dalam situasi ini, jumlah byte yang diperlukan dikembalikan dalam pdwSerializedSize.
SYNC_E_INVALID_OPERATION	Batch perubahan berisi grup yang dimulai tetapi tidak berakhir.
SYNC_E_INVALID_VERSION	Nilai targetFormatVersion lebih tinggi dari versi objek , atau objek berisi elemen yang tidak kompatibel dengan targetFormatVersion.

Keterangan

Tabel berikut ini menjelaskan bendera yang menentukan informasi tentang objek ISyncFilterInfo .

nilai SYNC_FILTER_INFO_FLAG	Deskripsi
SYNC_FILTER_INFO_FLAG_ITEM_LIST	Bendera ini menunjukkan bahwa kumpulan item yang disinkronkan dibatasi oleh filter item.
SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST	Objek IChangeUnitListFilterInfo menentukan bahwa perubahan hanya berlaku untuk subset unit perubahan yang ditentukan untuk cakupan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winsync.h

Lihat juga

Antarmuka ISyncChangeBatchBase

Antarmuka ISyncChangeBatchBase2

Antarmuka ISyncFilterInfo

Antarmuka ISyncKnowledge

Antarmuka ISyncKnowledge2

Enumerasi SyncSerializationVersion