ISyncMgrHandler::GetHandlerInfo-Methode (syncmgr.h)

Artikel
03/13/2024

Ruft Eigenschaften ab, die den Handler beschreiben.

Syntax

HRESULT GetHandlerInfo(
  [out] ISyncMgrHandlerInfo **ppHandlerInfo
);

Parameter

[out] ppHandlerInfo

Typ: ISyncMgrHandlerInfo**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine instance der ISyncMgrHandlerInfo-Schnittstelle, die Zugriff auf die Handlereigenschaften ermöglicht.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn diese Methode fehlschlägt, wird der Handler weiterhin im Ordner Sync Center angezeigt, und das Sync Center ruft ihn weiterhin auf, aber Standardwerte werden für alle Eigenschaften verwendet.

ISyncMgrHandler::GetHandlerInfo ersetzt zusammen mit ISyncMgrHandler::GetName die ältere GetHandlerInfo.

Beispiele

Das folgende Beispiel zeigt eine Implementierung dieser Methode.

STDMETHODIMP CMyDeviceHandler::GetHandlerInfo(
                             __out ISyncMgrHandlerInfo **ppHandlerInfo)
{
    *ppHandlerInfo = NULL;
    HRESULT hr = QueryInterface(IID_ISyncMgrHandlerInfo, 
                                (void **) ppHandlerInfo);
    return hr;
}

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