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
S_OK
Las instantáneas se han expuesto correctamente.
E_ACCESSDENIED
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
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_BAD_STATE
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.
VSS_E_OBJECT_NOT_FOUND
La instantánea especificada no existe.
VSS_E_PROVIDER_VETO
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.
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.

VSS_E_UNEXPECTED_PROVIDER_ERROR
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

IVssBackupComponents::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES