Método ISyncMgrControl::StartItemSync (syncmgr.h)

Inicia la sincronización de elementos especificados administrados por un controlador determinado.

Sintaxis

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Parámetros

[in] pszHandlerID

Tipo: LPCWSTR

Puntero a un búfer que contiene el identificador único del controlador que administra los elementos. Esta cadena tiene una longitud máxima MAX_SYNCMGR_ID incluido el carácter nulo de terminación.

[in] ppszItemIDs

Tipo: LPCWSTR*

Dirección de un puntero a un búfer que contiene una matriz de identificadores de los elementos que se van a sincronizar. Cada identificador es de longitud máxima MAX_SYNCMGR_ID incluido el carácter nulo de terminación. Esta matriz se pasa a Sincronizar.

[in] cItems

Tipo: DWORD

Número de identificadores en ppszItemIDs.

[in] hwndOwner

Tipo: HWND

Identificador de la ventana que el elemento puede usar para mostrar cualquier interfaz de usuario necesaria. Este valor puede ser NULL.

[in] punk

Tipo: IUnknown*

Puntero a un IUnknown que se va a pasar a Synchronize. Este parámetro puede ser NULL.

[in] nSyncControlFlags

Tipo: SYNCMGR_SYNC_CONTROL_FLAGS

Miembro de la enumeración SYNCMGR_SYNC_CONTROL_FLAGS que especifica si un elemento encontrado en una sincronización actual y una sincronización en cola se debe sincronizar de nuevo cuando se realiza la sincronización en cola.

[in] pResult

Tipo: ISyncMgrSyncResult*

Puntero a una instancia de ISyncMgrSyncResult, cuyo método Result se llama cuando finaliza la sincronización, ya sea mediante éxito, error o cancelación. Se llama al método Result con el estado agregado de la sincronización del controlador. Este parámetro puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método es análogo a UpdateItems.

Ejemplos

En el ejemplo siguiente se muestra el uso de ISyncMgrControl::StartItemSync mediante el procedimiento de un controlador.

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))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->Release();
    }

    ...

}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	syncmgr.h