Método IVssBackupComponents::ExposeSnapshot (vsbackup.h)

Artículo
08/27/2023

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