Compartir a través de


ISyncFilter::Serialize

Cuando lo invalida una clase derivada, serializa el filtro en una matriz de bytes.

HRESULT Serialize(
  BYTE * pbSyncFilter,
  DWORD * pcbSyncFilter);

Parámetros

  • pbSyncFilter
    [in, out, unique, size_is(*pcbSyncFilter)] Matriz de bytes que recibe los datos de filtro.
  • pcbSyncFilter
    [in, out] Especifica el número de bytes de pbSyncFilter. Devuelve el número de bytes necesarios para pbSyncFilter si pbSyncFilter es demasiado pequeño, o bien, el número de bytes escritos en pbSyncFilter si se escriben los datos.

Valor devuelto

  • S_OK.

  • HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pbChangeBatch es demasiado pequeño. En este caso, el número necesario de bytes se almacena en pcbChangeBatch.

  • Códigos de error determinados por el proveedor.

Notas

La primera vez que Sync Framework llama a este método, especifica NULL para pbSyncFilter y 0 para pcbSyncFilter. En esta situación, la implementación debe devolver el tamaño correcto para el identificador de elemento en pcbSyncFilter y un código de error de HRESULT_FROM_WIN32 (ERROR_MORE_DATA).

Cuando se implementa este método, el desarrollador también debe implementar ISyncFilterDeserializer::DeserializeSyncFilter para deserializar los datos serializados.

Si no es necesario serializar el filtro, este método puede devolver E_NOTIMPL.

Vea también

Referencia

Interfaz ISyncFilter