ISyncMgrSynchronize::SetItemStatus-Methode (mobsync.h)

Artikel
03/04/2024

Wird vom Handler einer registrierten Anwendung aufgerufen, um die status eines Elements in den folgenden beiden Fällen zu ändern: zwischen dem Zeitpunkt, zu dem der Handler von der ISyncMgrSynchronize::P repareForSync-Methode zurückgegeben und die Rückrufmethode PrepareForSyncCompleted aufgerufen hat, oder nachdem der Handler von der ISyncMgrSynchronize::Synchronize-Methode zurückgegeben wurde, aber noch nicht die SynchronizeCompleted-Rückrufmethode aufgerufen hat.

Syntax

HRESULT SetItemStatus(
  [in] REFGUID pItemID,
  [in] DWORD   dwSyncMgrStatus
);

Parameter

[in] pItemID

Typ: REFGUID

Identifiziert das Element mit geändertem status.

[in] dwSyncMgrStatus

Art: DWORD

Der neue status für das angegebene Element aus der SYNCMGRSTATUS-Enumeration.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie Folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Status wurde festgelegt.

Hinweise

Derzeit ist der einzige SYNCMGRSTATUS-status Wert, der von SyncMgr unterstützt wird, SYNCMGRSTATUS_SKIPPED. Der Handler der registrierten Anwendung sollte das in pItemID angegebene Element überspringen, wenn er diesen status Wert empfängt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mobsync.h
DLL	Mobsync.dll