Metodo ISyncMgrHandlerCollection::BindToHandler (syncmgr.h)

Crea un'istanza di un gestore di sincronizzazione specificato quando viene chiamato dal Centro sincronizzazione.

Sintassi

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

Parametri

[in] pszHandlerID

Tipo: LPCWSTR

ID del gestore di sincronizzazione.

[in] riid

Tipo: REFIID

Id dell'interfaccia richiesta. Questo in genere sarà IID_ISyncMgrHandler. Se il metodo ha esito negativo quando viene passato IID_ISyncMgrHandler, viene richiamato usando IID_ISyncMgrSynchronize, l'IID dell'interfaccia ISyncMgrSynchronize precedente. Quando il metodo restituisce correttamente, viene fatto riferimento a un puntatore all'interfaccia richiesta nel parametro ppv .

[out] ppv

Tipo: void**

Quando questo metodo restituisce, contiene un indirizzo di un puntatore a un'interfaccia che rappresenta il gestore di sincronizzazione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È possibile che questo metodo venga chiamato da Sync Center senza prima chiamare ISyncMgrHandlerCollection::GetHandlerEnumerator. Ciò avviee perché Il Centro sincronizzazione memorizza nella cache le informazioni sui gestori e sui relativi elementi. La raccolta del gestore può restituire un puntatore dell'interfaccia per un gestore di sincronizzazione esistente oppure può creare una nuova istanza.

Requisiti

Vedi anche

ISyncMgrHandler

ISyncMgrHandlerCollection