Método CVssWriter::Initialize (vswriter.h)
Inicializa um objeto CVssWriter e permite que um aplicativo gravador interaja com o VSS.
Initialize é um método público implementado pela classe base CVssWriter .
Sintaxe
HRESULT Initialize(
[in] VSS_ID WriterId,
[in] LPCWSTR wszWriterName,
[in] VSS_USAGE_TYPE ut,
[in] VSS_SOURCE_TYPE st,
[in] VSS_APPLICATION_LEVEL nLevel,
[in] DWORD dwTimeoutFreeze,
[in] VSS_ALTERNATE_WRITER_STATE aws,
[in] bool bIOThrottlingOnly,
[in] LPCWSTR wszWriterInstanceName
);
Parâmetros
[in] WriterId
O GUID (identificador global exclusivo) da classe de gravador.
[in] wszWriterName
Uma cadeia de caracteres largos terminada em nulo que contém o nome do gravador. Essa cadeia de caracteres não está localizada.
[in] ut
Um VSS_USAGE_TYPE valor de enumeração que indica como os dados gerenciados pelo gravador são usados no sistema host.
[in] st
Um VSS_SOURCE_TYPE valor de enumeração que indica o tipo de dados gerenciados pelo gravador.
[in] nLevel
Um VSS_APPLICATION_LEVEL valor de enumeração que indica o nível do aplicativo no qual o gravador recebe uma notificação de evento Freeze .
O valor padrão desse parâmetro é VSS_APP_FRONT_END.
[in] dwTimeoutFreeze
O tempo máximo permitido, em milissegundos, entre o recebimento de uma notificação de evento Freeze por um gravador e o recebimento de uma notificação de evento thaw correspondente do VSS. Depois que o tempo limite expirar, o método CVssWriter::OnAbort do gravador será chamado automaticamente.
O valor padrão para esse parâmetro é 60000.
[in] aws
Um VSS_ALTERNATE_WRITER_STATE valor de enumeração que indica se o gravador tem um gravador alternativo associado.
O valor padrão para esse parâmetro é VSS_AWS_NO_ALTERNATE_WRITER. O chamador não deve substituir esse valor padrão. Esse parâmetro é reservado para uso futuro.
[in] bIOThrottlingOnly
Defina esse parâmetro como true se os métodos de limitação de E/S estiverem habilitados ou false caso contrário.
O valor padrão para esse parâmetro é false. O chamador não deve substituir esse valor padrão. Esse parâmetro é reservado para uso futuro.
[in] wszWriterInstanceName
Uma cadeia de caracteres largos terminada em nulo que contém o nome da instância do gravador.
O valor padrão para esse parâmetro é NULL. Se o gravador tiver várias instâncias e exigir eventos de restauração, esse parâmetro será necessário e não poderá ser NULL. Para obter detalhes, consulte a seção Comentários a seguir.
Windows Server 2003 e Windows XP: Antes do Windows Server 2003 com SP1, esse parâmetro é reservado para uso do sistema e o chamador não deve substituir o valor padrão.
Valor retornado
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
Inicializou com êxito o objeto writer. |
|
O objeto gravador não pôde ser inicializado; a infraestrutura do gravador vss estava inativa porque o Windows estava no modo de segurança ou estava configurando. |
|
O chamador não é um administrador. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado. |
Comentários
O VSS atribui uma ID de instância de gravador exclusiva a cada instância de um aplicativo gravador. Se mais de uma instância estiver presente no sistema ao mesmo tempo (por exemplo, se vários servidores SQL estiverem em execução em um sistema), cada gravador será identificado exclusivamente pela combinação de sua ID de classe de gravador e sua ID de instância de gravador.
O parâmetro wszWriterInstanceName permite que um gravador de várias instâncias especifique um nome persistente para cada instância de gravador como uma cadeia de caracteres legível por humanos. Esse nome deve ser exclusivo em todas as instâncias do gravador no sistema. Se um gravador tiver várias instâncias e exigir eventos de restauração, ele deverá especificar uma cadeia de caracteres não NULL para esse parâmetro. O VSS usa o nome da instância para restaurar corretamente gravadores de várias instâncias.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |