Método IVssBackupComponents::GetSnapshotProperties (vsbackup.h)
El método GetSnapshotProperties obtiene las propiedades de la instantánea especificada.
Sintaxis
HRESULT GetSnapshotProperties(
[in] VSS_ID SnapshotId,
[out] VSS_SNAPSHOT_PROP *pProp
);
Parámetros
[in] SnapshotId
Identificador de la instantánea de un volumen tal y como devuelve IVssBackupComponents::AddToSnapshotSet.
[out] pProp
Dirección de una estructura de VSS_SNAPSHOT_PROP asignada por el autor de la llamada que recibe las propiedades de instantánea. El proveedor de software es responsable de establecer los miembros de esta estructura. El proveedor de software asigna memoria para todos los miembros de cadena que establece en la estructura. Cuando la estructura ya no es necesaria, el proveedor de software es responsable de liberar estas cadenas mediante una llamada a la función VssFreeSnapshotProperties .
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Devolvió correctamente las propiedades de instantáneas. |
|
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador. |
|
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 objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
|
La instantánea especificada no existe. |
|
Se esperaba un error de proveedor. El proveedor registró el error en el registro de eventos. 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. |
|
Error inesperado del proveedor. El código de error se registra en el registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS. |
Comentarios
El llamador debe establecer el contenido de la estructura de VSS_SNAPSHOT_PROP en cero antes de llamar al método GetSnapshotProperties .
El proveedor es responsable de asignar y liberar las cadenas en la estructura VSS_SNAPSHOT_PROP .
Requisitos
| 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
IVssBackupComponents::AddToSnapshotSet