Método IVssBackupComponents::D isableWriterInstances (vsbackup.h)
O método DisableWriterInstances desabilita uma instância ou instância de gravador especificada.
Sintaxe
HRESULT DisableWriterInstances(
[in] const VSS_ID *rgWriterInstanceId,
[in] UINT cInstanceId
);
Parâmetros
[in] rgWriterInstanceId
Uma matriz que contém um ou mais identificadores de instância de gravador.
[in] cInstanceId
O número de entradas na matriz rgWriterInstanceId .
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
A classe de gravador foi habilitada com êxito. |
|
O chamador não tem privilégios de backup suficientes ou não é um administrador. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta. |
|
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 em 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
Se você tiver várias cópias em execução do mesmo gravador, todas elas terão o mesmo identificador de classe de gravador, mas terão diferentes identificadores de instância de gravador. Desabilitar uma instância de um gravador não faz com que outras instâncias do gravador sejam desabilitadas.
Se você chamar DisableWriterInstances, deverá fazer isso antes de chamar o método IVssBackupComponents::GatherWriterMetadata . Se você chamar GatherWriterMetadata primeiro e chamar DisableWriterInstances, a chamada para DisableWriterInstances não terá efeito. Se você precisar chamar GatherWriterMetadata primeiro, para determinar quais instâncias de gravador desabilitar, deverá chamá-la de uma instância diferente da interface IVssBackupComponents .
Requisitos
| Requisito | Valor |
|---|---|
| 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 | vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |
Confira também
IVssBackupComponents::D isableWriterClasses