Condividi tramite


ICoreFragment::NextColumn

Restituisce l'ID unità di modifica successivo nel set di ID unità di modifica a cui si applica questo frammento di conoscenza.

HRESULT NextColumn(
  BYTE* pChangeUnitId,
  DWORD* pChangeUnitIdSize);

Parametri

Termine

Definizione

pChangeUnitId

[in, out, unique, size_is(*pChangeUnitIdSize)] Restituisce l'ID unità di modifica successivo nel set.

pChangeUnitIdSize

[in, out] Specifica il numero di byte in pChangeUnitId. Restituisce il numero di byte necessari per recuperare l'ID se pChangeUnitId è troppo piccolo oppure il numero di byte scritti.

Valore restituito

  • S_OK.

  • S_FALSE se non rimangono ID unità di modifica da enumerare.

  • E_POINTER se l'ID unità di modifica è un ID a lunghezza variabile e pChangeUnitIdSize è NULL.

  • HRESULT_FROM_WIN32 (ERROR_MORE_DATA) se pChangeUnitId è troppo piccolo. In questo caso, il numero necessario di byte viene restituito in pChangeUnitIdSize.

  • SYNC_E_INVALID_OPERATION se l'oggetto conoscenza contenuto in questo oggetto è stato modificato dalla creazione di questo oggetto.

Osservazioni

Un oggetto ISyncKnowledge2 contiene uno o più oggetti ICoreFragment. Ogni oggetto contiene la conoscenza che si applica a un set specifico di colonne. Una colonna viene rappresentata come un'unità di modifica. In genere, uno degli oggetti ICoreFragment non contiene colonne. Se un oggetto ICoreFragment non contiene colonne, la relativa conoscenza si applica a tutte le unità di modifica non specificate in nessun altro frammento. In questa situazione NextColumn restituisce sempre S_FALSE.

Vedere anche

Riferimento

Interfaccia ICoreFragment