Método IVssBackupComponents::ExposeSnapshot (vsbackup.h)
El método ExposeSnapshot expone una instantánea como una letra de unidad, una carpeta montada o un recurso compartido de archivos.
Sintaxis
HRESULT ExposeSnapshot(
[in] VSS_ID SnapshotId,
[in] VSS_PWSZ wszPathFromRoot,
[in] LONG lAttributes,
[in] VSS_PWSZ wszExpose,
[out] VSS_PWSZ *pwszExposed
);
Parámetros
[in] SnapshotId
Identificador de instantánea.
[in] wszPathFromRoot
Ruta de acceso a la parte del volumen disponible al exponer una instantánea como un recurso compartido de archivos. El valor de este parámetro debe ser NULL al exponer una instantánea localmente; es decir, exponerlo como una letra de unidad o una carpeta montada.
La ruta de acceso no puede contener variables de entorno (por ejemplo, %MyEnv%) o caracteres comodín.
No es necesario que la ruta de acceso termine con una barra diagonal inversa (""). Es necesario que las aplicaciones recuperen esta información para comprobarla.
[in] lAttributes
Atributos de la instantánea expuesta que indica si se expone local o remotamente. El valor debe ser el VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY o el valor VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
[in] wszExpose
Cuando una instantánea se expone como un recurso compartido de archivos, el valor de este parámetro es el nombre del recurso compartido. Si una instantánea se expone montando como un dispositivo, el valor del parámetro es una letra de unidad seguida de dos puntos( por ejemplo, "X:" o una ruta de acceso de carpeta montada (por ejemplo, "Y:\MountX"). Si el valor de este parámetro es NULL, VSS determina el nombre del recurso compartido o la letra de unidad si el parámetro lAttributes es VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY.
[out] pwszExposed
Nombre expuesto de la instantánea. Se trata de un nombre de recurso compartido, una letra de unidad seguida de dos puntos o una carpeta montada. El valor es NULL si se produjo un error en ExposeSnapshot . VSS asigna la memoria para esta cadena.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Las instantáneas se han expuesto correctamente. |
|
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 autor de la llamada es responsable de liberar la cadena a la que apunta el parámetro pwszExposed llamando a la función CoTaskMemFree .
Al exponer una instantánea persistente, permanece expuesta a través de arranques posteriores.
Al exponer una instantánea de un volumen, la instantánea se puede tratar como un dispositivo montable o como un sistema de archivos disponible para el uso compartido de archivos.
Cuando se expone como un dispositivo, como con otros dispositivos montables, la instantánea de un volumen se expone en su punto de montaje (letra de unidad o carpeta montada) empezando por su raíz.
Cuando se expone como un recurso compartido de archivos, se pueden compartir subconjuntos (indicados por wszPathFromRoot) del volumen.
Para obtener más información sobre cómo exponer instantáneas, vea Exponer y exponer volúmenes copiados de sombras.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [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::ImportSnapshots