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

Notifica o Centro de Sincronização de que a sincronização dos itens especificados foi iniciada.

Sintaxe

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

Parâmetros

[in] pszHandlerID

Tipo: LPCWSTR

Um ponteiro para um buffer que contém a ID exclusiva do manipulador. Essa cadeia de caracteres tem o comprimento máximo MAX_SYNCMGR_ID incluindo o caractere nulo de terminação.

[in] ppszItemIDs

Tipo: LPCWSTR*

O endereço de um ponteiro para um buffer que contém uma matriz de IDs de item, gerenciado pelo manipulador especificado em pszHandlerID, a ser sincronizado. Cada ID tem o comprimento máximo MAX_SYNCMGR_ID incluindo o caractere nulo de terminação.

[in] cItems

Tipo: ULONG

O número de IDs de item contidas no buffer referenciado em ppszItemIDs.

[in] ppCallback

Tipo: ISyncMgrSyncCallback**

O endereço de um ponteiro para uma instância de ISyncMgrSyncCallback usada para relatar o progresso e os eventos. Esse valor poderá ser NULL se nenhum retorno de chamada for necessário.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

PszHandlerID e ppszItemIDs devem ser especificados.

Exemplos

O exemplo a seguir mostra a estrutura de tópicos de uma implementação desse método.

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

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

    return hr;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	syncmgr.h