ICoreFragment::NextColumn
Devuelve el siguiente identificador de la unidad de cambio en el conjunto de identificadores de unidad de cambio al que se aplica este fragmento del conocimiento.
HRESULT NextColumn(
BYTE* pChangeUnitId,
DWORD* pChangeUnitIdSize);
Parámetros
Término |
Definición |
pChangeUnitId |
[in, out, unique, size_is(*pChangeUnitIdSize)] Devuelve el siguiente identificador de la unidad de cambio en el conjunto. |
pChangeUnitIdSize |
[in, out] Especifica el número de bytes de pChangeUnitId. Devuelve el número de bytes necesarios para recuperar el identificador si pChangeUnitId es demasiado pequeño, o devuelve el número de bytes escritos. |
Valor devuelto
S_OK.
S_FALSE si no hay más identificadores de la unidad de cambio a enumerar.
E_POINTER si el identificador de la unidad de cambio es un identificador de longitud variable y pChangeUnitIdSize es NULL.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pChangeUnitId es demasiado pequeño. En esta situación, el número necesario de bytes se devuelve en pChangeUnitIdSize.
SYNC_E_INVALID_OPERATION si el objeto de conocimiento que contiene este objeto hubiera cambiado desde que se creó este objeto.
Notas
Un objeto ISyncKnowledge2 contiene uno o más objetos ICoreFragment. Cada objeto contiene conocimiento que se aplica a un conjunto concreto de columnas. Una columna se representa como una unidad de cambio. Normalmente, uno de los objetos ICoreFragment no contiene columnas. Cuando un objeto ICoreFragment no contiene columnas, su conocimiento se aplica a todas las unidades de cambio que no se especifican en ningún otro fragmento. En esta situación, NextColumn siempre devuelve S_FALSE.