Compartilhar via

Método IVssExamineWriterMetadataEx::GetIdentityEx (vsbackup.h)

  • Artigo

O método GetIdentityEx obtém o nome da instância do gravador e outras informações básicas sobre uma instância de gravador específica.

Sintaxe

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

Parâmetros

[out] pidInstance

GUID (identificador global exclusivo) da instância do gravador.

[out] pidWriter

GUID da classe de gravador.

[out] pbstrWriterName

Ponteiro para uma cadeia de caracteres que especifica o nome do gravador.

[out] pbstrInstanceName

Ponteiro para uma cadeia de caracteres que especifica o nome da instância do gravador.

[out] pUsage

Ponteiro para um valor de enumeração VSS_USAGE_TYPE indicando como os dados gerenciados pelo gravador são usados no sistema host.

[out] pSource

Ponteiro para um valor de enumeração VSS_SOURCE_TYPE indicando 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 em 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 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

Esse método é idêntico ao método IVssExamineWriterMetadata::GetIdentity , exceto pelo parâmetro pbstrInstanceName .

O parâmetro pbstrInstanceName é o nome da instância do gravador especificado durante a inicialização do gravador por CVssWriter::Initialize.

O nome da instância do gravador é útil para gravadores que dão suporte à execução de várias instâncias de gravador com a mesma ID de classe de gravador em um único computador. O nome da instância do gravador pode ser usado para identificar a instância específica. Portanto, o gravador deve tornar o nome da instância exclusivo dentro da classe de gravador. Além disso, espera-se que o nome da instância do gravador persista entre backup e restauração e é usado pelo VSS para restaurar corretamente gravadores de várias instâncias.

O chamador deve liberar a memória mantida pelos parâmetros pbstrWriterName e pbstrInstanceName chamando SysFreeString.

Uma interface IVssExamineWriterMetadataEx pode ser de informações de estado de gravador armazenadas (criadas por uma chamada para CreateVssExamineWriterMetadata). Se esse for o caso, os seguintes serão verdadeiros:

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [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

CVssWriter::Initialize

IVssExamineWriterMetadataEx