取得合併標記的成功識別碼值。
HRESULT GetMergeWinnerId(
BYTE * pbWinnerId,
ULONG * pcbWinnerId);
參數
- pbWinnerId
[in, out, size_is(*pcbWinnerId), unique] 傳回合併標記的成功識別碼值。
- pcbWinnerId
[in, out] 指定 pbWinnerId 中的位元組數目。如果 pbWinnerId 太小，就傳回擷取此識別碼所需的位元組數目，或傳回寫入的位元組數目。
傳回值
S_OK。
如果此項目不是合併標記，則為 S_FALSE。
E_POINTER。
當 pbWinnerId 太小時，為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的位元組數目是在 pcbWinnerId 中傳回。
備註
當條件約束衝突是透過合併兩個發生衝突的項目所解決時，就會建立合併標記。當條件約束衝突是透過合併來解決時，系統會選擇較小的項目識別碼做為成功項目識別碼，而較大的則是失敗項目識別碼。成功項目識別碼會用來識別合併項目。合併標記會追蹤失敗項目識別碼與成功項目識別碼在同步處理社群中識別相同的項目。合併標記的中繼資料與已刪除項目標記的中繼資料相同，而且加入了成功項目識別碼。