ISyncMgrHandlerCollection::BindToHandler-Methode (syncmgr.h)

  • Artikel

Instanziiert einen angegebenen Synchronisierungshandler, wenn er vom Sync Center aufgerufen wird.

Syntax

HRESULT BindToHandler(
  [in]  LPCWSTR pszHandlerID,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parameter

[in] pszHandlerID

Typ: LPCWSTR

Die ID des Synchronisierungshandlers.

[in] riid

Typ: REFIID

Die IID der angeforderten Schnittstelle. Dies wird in der Regel IID_ISyncMgrHandler. Wenn die Methode beim Übergeben IID_ISyncMgrHandler fehlschlägt, wird sie mithilfe von IID_ISyncMgrSynchronize abgerufen, der IID der älteren ISyncMgrSynchronize-Schnittstelle . Wenn die Methode erfolgreich zurückgegeben wird, wird im ppv-Parameter auf die angeforderte Schnittstelle verwiesen.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine Schnittstelle, die den Synchronisierungshandler darstellt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Es ist möglich, dass diese Methode vom Sync Center aufgerufen wird, ohne dass zuerst ISyncMgrHandlerCollection::GetHandlerEnumerator aufgerufen wird. Dies liegt daran, dass das Synchronisierungscenter Informationen zu Handlern und deren Elementen zwischenspeichert. Die Handlerauflistung kann einen Schnittstellenzeiger für einen vorhandenen Synchronisierungshandler zurückgeben oder eine neue instance erstellen.

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

Weitere Informationen

ISyncMgrHandler

ISyncMgrHandlerCollection