Compartilhar via

Método IVssExamineWriterMetadata::GetIdentity (vsbackup.h)

  • Artigo

O método GetIdentity obtém informações básicas sobre uma instância de gravador específica.

Sintaxe

HRESULT GetIdentity(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

Parâmetros

[out] pidInstance

O endereço de uma variável alocada pelo chamador que recebe o identificador de instância do gravador.

[out] pidWriter

O endereço de uma variável alocada pelo chamador que recebe o identificador de classe do gravador.

[out] pbstrWriterName

O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o nome do gravador.

[out] pUsage

O endereço de uma variável alocada pelo chamador que recebe um valor de enumeração VSS_USAGE_TYPE que especifica como os dados gerenciados pelo gravador são usados no sistema host.

[out] pSource

O endereço de uma variável alocada pelo chamador que recebe um valor de enumeração VSS_SOURCE_TYPE que especifica o tipo de dados gerenciados pelo gravador.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
 Retornou com êxito as informações de identidade.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_INVALID_XML_DOCUMENT
 O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.
VSS_E_UNEXPECTED
 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 chamador deve liberar a memória mantida pelo parâmetro pbstrWriterName chamando SysFreeString.

Uma interface IVssExamineWriterMetadata pode ser de informações de estado do gravador armazenadas (criadas por uma chamada para CreateVssExamineWriterMetadata). Se esse for o caso, o seguinte será verdadeiro:

  • pidInstance pode não significar nada em termos de escritores ao vivo.
  • Se pidWriter não corresponder à classe de gravador de nenhum gravador ao vivo, um solicitante não deverá usar os componentes desse gravador.

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

CreateVssExamineWriterMetadata

IVssExamineWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE