Compartir a través de

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

  • Artículo

El método GetIdentity obtiene información básica sobre una instancia de escritor específica.

Sintaxis

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

Dirección de una variable asignada por el autor de la llamada que recibe el identificador de instancia del escritor.

[out] pidWriter

Dirección de una variable asignada por el autor de la llamada que recibe el identificador de clase del escritor.

[out] pbstrWriterName

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene el nombre del escritor.

[out] pUsage

Dirección de una variable asignada por el autor de la llamada que recibe un valor de enumeración VSS_USAGE_TYPE que especifica cómo se usan los datos administrados por el escritor en el sistema host.

[out] pSource

Dirección de una variable asignada por el autor de la llamada que recibe un valor de enumeración VSS_SOURCE_TYPE que especifica el tipo de datos administrados por el escritor.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 Devolvió correctamente la información de identidad.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
 El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

El llamador debe liberar la memoria que mantiene el parámetro pbstrWriterName llamando a SysFreeString.

Una interfaz IVssExamineWriterMetadata puede provenír de la información de estado del escritor almacenada (creada por una llamada a CreateVssExamineWriterMetadata). Si este es el caso, se cumple lo siguiente:

  • pidInstance puede no significar nada en términos de escritores en directo.
  • Si pidWriter no coincide con la clase writer de ningún escritor en directo, un solicitante no debe usar los componentes del escritor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

CreateVssExamineWriterMetadata

IVssExamineWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE