ICoreFragment::NextColumn
Retorna a ID da próxima unidade de alteração no conjunto de IDs de unidades de alteração ao qual este fragmento de conhecimento se aplica.
HRESULT NextColumn(
BYTE* pChangeUnitId,
DWORD* pChangeUnitIdSize);
Parâmetros
Termo |
Definição |
pChangeUnitId |
[in, out, unique, size_is(*pChangeUnitIdSize)] Retorna a ID da próxima unidade de alteração no conjunto. |
pChangeUnitIdSize |
[in, out] Especifica o número de bytes em pChangeUnitId. Retorna o número de bytes necessários para recuperar a ID quando pChangeUnitId é muito pequeno, ou retorna o número de bytes gravados. |
Valor de retorno
S_OK.
S_FALSE quando não houver mais IDs de unidades de alteração a serem enumeradas.
E_POINTER quando a ID da unidade de alteração é uma ID de comprimento variável e pChangeUnitIdSize é NULL.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pChangeUnitId é muito pequeno. Nessa situação, o número de bytes necessário é retornado em pChangeUnitIdSize.
SYNC_E_INVALID_OPERATION se o objeto de conhecimento contido neste objeto tiver sido alterado desde que o objeto foi criado.
Comentários
Um objeto ISyncKnowledge2 contém um ou mais objetos ICoreFragment. Cada objeto contém o conhecimento aplicável a um conjunto específico de colunas. Uma coluna é representada como uma unidade de alteração. Em geral, um dos objetos ICoreFragment não contém colunas. Quando um objeto ICoreFragment não contém colunas, seu conhecimento se aplica a todas as unidades de alteração que não estão especificadas em nenhum outro fragmento. Nessa situação, NextColumn sempre retorna S_FALSE.