ISyncMgrControl::UpdateHandlerCollection-Methode (syncmgr.h)
Weist das Synchronisierungscenter an, die Handlerauflistung neu aufzulisten, oder informiert sie darüber, dass sich die Eigenschaften eines Handlers in der Handlerauflistung geändert haben.
Syntax
HRESULT UpdateHandlerCollection(
[in] REFCLSID rclsidCollectionID,
[in] SYNCMGR_CONTROL_FLAGS nControlFlags
);
Parameter
[in] rclsidCollectionID
Typ: REFCLSID
Ein Verweis auf die CLSID der Handlersammlung.
[in] nControlFlags
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 UpdateHandlerCollection erst zurückgegeben, wenn das Sync Center die angegebene Handlerauflistung geladen und alle Handler- und Elementinformationen neu geladen hat.
Beispiele
Das folgende Beispiel zeigt die Verwendung von ISyncMgrControl::UpdateHandlerCollection durch die Prozedur eines Handlers.
void CMyDeviceHandler::MiscProc(...)
{
...
// 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 a new computer has been added.
hr = pControl->UpdateHandlerCollection(CLSID_FRSHandlerCollection,
SYNCMGR_CF_NOWAIT);
pControl->Release();
}
...
}
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | syncmgr.h |