在套用此知識片段的一組目標變更單位識別碼中，傳回下一個變更單位識別碼。
HRESULT NextColumn(
BYTE* pChangeUnitId,
DWORD* pChangeUnitIdSize);
參數
術語 |
定義 |
pChangeUnitId |
[in, out, unique, size_is(*pChangeUnitIdSize)] 傳回集合中的下一個變更單位識別碼。 |
pChangeUnitIdSize |
[in, out] 指定 pChangeUnitId 中的位元組數目。如果 pChangeUnitId 太小，就傳回擷取此識別碼所需的位元組數目，或寫入的位元組數目。 |
傳回值
S_OK。
如果已經沒有其他變更單位識別碼可列舉，則為 S_FALSE。
如果變更單位識別碼為可變長度識別碼，而 pChangeUnitIdSize 為 NULL，則為 E_POINTER。
當 pChangeUnitId 太小時，為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的位元組數目是在 pChangeUnitIdSize 中傳回。
如果此物件中包含的知識物件在這個物件建立之後已經變更，則為 SYNC_E_INVALID_OPERATION。
備註
一個 ISyncKnowledge2 物件包含一個或多個 ICoreFragment 物件。每個物件都包含套用至一組特定之「資料行」(Column) 的知識。資料行是以變更單位表示。通常，其中一個 ICoreFragment 物件不包含任何資料行。當 ICoreFragment 物件不包含任何資料行時，其知識會套用到在其他任何片段中未指定的所有變更單位。在這種情況下，NextColumn 永遠會傳回 S_FALSE。