Compartir a través de

Método ISyncMgrSessionCreator::CreateSession (syncmgr.h)

  • Artículo

Notifica al Centro de sincronización que ha comenzado la sincronización de los elementos especificados.

Sintaxis

HRESULT CreateSession(
  [in] LPCWSTR              pszHandlerID,
  [in] LPCWSTR              *ppszItemIDs,
  [in] ULONG                cItems,
  [in] ISyncMgrSyncCallback **ppCallback
);

Parámetros

[in] pszHandlerID

Tipo: LPCWSTR

Puntero a un búfer que contiene el identificador único del controlador. 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 elemento, administrado por el controlador especificado en pszHandlerID, que se va a sincronizar. Cada identificador tiene una longitud máxima MAX_SYNCMGR_ID incluido el carácter nulo de terminación.

[in] cItems

Tipo: ULONG

Número de identificadores de elemento contenidos en el búfer al que se hace referencia en ppszItemIDs.

[in] ppCallback

Tipo: ISyncMgrSyncCallback**

Dirección de un puntero a una instancia de ISyncMgrSyncCallback usada para notificar el progreso y los eventos. Este valor puede ser NULL si no se necesita ninguna devolución de llamada.

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

Se deben especificar pszHandlerID y ppszItemIDs .

Ejemplos

En el ejemplo siguiente se muestra el esquema de una implementación de este método.

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // Perform synchronization.
    }

    return hr;
}

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