Método IVssExamineWriterMetadataEx::GetIdentityEx (vsbackup.h)
El método GetIdentityEx obtiene el nombre de la instancia de escritor y otra información básica sobre una instancia de escritor específica.
Sintaxis
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
Identificador único global (GUID) de la instancia de escritor.
[out] pidWriter
GUID de la clase writer.
[out] pbstrWriterName
Puntero a una cadena que especifica el nombre del escritor.
[out] pbstrInstanceName
Puntero a una cadena que especifica el nombre de la instancia del escritor.
[out] pUsage
Puntero a un valor de enumeración VSS_USAGE_TYPE que indica cómo se usan los datos administrados por el escritor en el sistema host.
[out] pSource
Puntero a un valor de enumeración VSS_SOURCE_TYPE que indica 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 |
|---|---|
|
Devolvió correctamente la información de identidad. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
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. |
|
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
Este método es idéntico al método IVssExamineWriterMetadata::GetIdentity excepto para el parámetro pbstrInstanceName .
El parámetro pbstrInstanceName es el nombre de instancia del escritor especificado durante la inicialización del escritor por parte de CVssWriter::Initialize.
El nombre de instancia del escritor es útil para escritores que admiten la ejecución de varias instancias de escritor con el mismo identificador de clase de escritor en un único equipo. El nombre de la instancia del escritor se puede usar para identificar la instancia específica. Por lo tanto, el escritor debe hacer que el nombre de instancia sea único dentro de la clase writer. Además, se espera que el nombre de la instancia del escritor persista entre la copia de seguridad y la restauración, y VSS la usa para restaurar correctamente los escritores de varias instancias.
El llamador debe liberar la memoria mantenida por los parámetros pbstrWriterName y pbstrInstanceName llamando a SysFreeString.
Una interfaz IVssExamineWriterMetadataEx 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 Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |