Compartilhar via


Método CVssWriterEx2::GetSessionId (vswriter.h)

Retorna o identificador de sessão do gravador.

Sintaxe

HRESULT GetSessionId(
  [out] VSS_ID *idSession
);

Parâmetros

[out] idSession

Um ponteiro para uma variável que recebe o identificador de sessão.

Retornar valor

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

Comentários

O identificador de sessão é um valor opaco que identifica exclusivamente uma sessão de backup ou restauração. Ele é usado para distinguir a sessão atual entre várias sessões paralelas de backup ou restauração.

Como prática recomendada, gravadores e solicitantes devem incluir a ID da sessão em todas as mensagens diagnóstico usadas para registro em log e rastreamento de eventos.

Se o manipulador de eventos de um gravador (como CVssWriter::OnFreeze) chamar esse método, ele deverá fazer isso no mesmo thread que chamou o manipulador de eventos. Para obter mais informações, consulte Tratamento de eventos do gravador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

CVssWriterEx2

IVssBackupComponentsEx3::GetSessionId