ISyncMgrControl::UpdateConflicts-Methode (syncmgr.h)

Artikel
08/26/2023

Informiert das Synchronisierungscenter darüber, dass Konflikte für einen bestimmten Handler oder ein bestimmtes Element hinzugefügt wurden.

Syntax

HRESULT UpdateConflicts(
  [in] LPCWSTR               pszHandlerID,
  [in] LPCWSTR               pszItemID,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

Parameter

[in] pszHandlerID

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die eindeutige ID des Handlers enthält, der das Element verwaltet. Diese Zeichenfolge hat eine maximale Länge MAX_SYNCMGR_ID einschließlich des beendenden NULL-Zeichens .

[in] pszItemID

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die eindeutige ID des Elements enthält. Diese Zeichenfolge hat eine maximale Länge MAX_SYNCMGR_ID einschließlich des beendenden NULL-Zeichens . Dieser Parameter kann NULL sein, wenn das Ereignis auf dem Handler und nicht auf einem bestimmten Element aufgetreten ist.

[in] nControlFlags

Typ: SYNCMGR_CONTROL_FLAGS

Ein Wert aus der SYNCMGR_CONTROL_FLAGS Enumeration, die angibt, ob das Update synchron oder asynchron ausgeführt werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn SYNCMGR_CF_WAIT im nControlFlags-Parameter festgelegt ist, wird UpdateConflicts erst zurückgegeben, wenn das Sync Center den angegebenen Handler geladen, den Konfliktspeicher des Handlers abgerufen und alle Konflikte aus diesem Speicher neu geladen hat. Wenn der Handler von einer Handlerauflistung bereitgestellt wird, wird auch die Handlerauflistung geladen, um den Handler neu zu laden.

Beispiele

Das folgende Beispiel zeigt die Verwendung von ISyncMgrControl::UpdateEvents durch die Prozedur eines Handlers.

void CMyDeviceHandler::Synchronize(...)
{
    ...
    // Add conflicts to the event store.

    // Get the Sync Center control object.
    ISyncMgrControl *pControl = NULL;
    
    hr = CoCreateInstance(CLSID_SyncMgrControl, 
                          CLSCTX_SERVER, 
                          IID_PPV_ARGS(&pControl));
    if (SUCCEEDED(hr))
    {
        // Tell Sync Center that we added events to our event store.
        // By passing NULL in pszItemID, we tell Sync Center that the conflict
        // occurred on the handler rather than a specific item.
        hr = pControl->UpdateConflicts(s_szMyDeviceSyncHandlerID, 
                                       NULL,
                                       SYNCMGR_CF_NOWAIT);
        pControl->Release();
    }

    ...

}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncmgr.h

Freigeben über