Método CVssWriter::GetSnapshotDeviceName (vswriter.h)

El método GetSnapshotDeviceName devuelve el nombre del dispositivo que hospeda la instantánea del volumen o recurso compartido de archivos especificado. Este método permite a los escritores admitir instantáneas de recuperación automática y solo se puede llamar durante el procesamiento del método OnPostSnapshot .

Sintaxis

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Parámetros

[in] wszOriginalVolume

Nombre del volumen original o la ruta de acceso UNC del recurso compartido de archivos original que contiene los datos usados para el conjunto de instantáneas actual. El nombre del volumen debe estar en uno de los siguientes formatos y debe incluir una barra diagonal inversa final (\):

  • Ruta de acceso de una carpeta montada, por ejemplo, Y:\MountX\
  • Una letra de unidad, por ejemplo, D:\
  • Ruta de acceso guid de volumen del formulario \\?\Volume{GUID}\ (donde GUID identifica el volumen)
  • Ruta de acceso UNC que especifica un recurso compartido de archivos remoto, por ejemplo, \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Dirección de un LPCWSTR que recibirá un puntero al nombre del dispositivo de la instantánea.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
Devolvió correctamente el nombre del volumen de instantáneas.
E_INVALIDARG
Uno de los valores de parámetro no es válido.
VSS_E_BAD_STATE
La llamada no se realizó durante el evento PostSnapshot.
VSS_E_OBJECT_NOT_FOUND
El parámetro wszOriginalVolume no es uno de los volúmenes ni recursos compartidos de archivos del conjunto de instantáneas.

Comentarios

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: Los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012.

Para obtener el nombre del volumen original del parámetro wszOriginalVolume , primero llame al método CVssWriter::GetCurrentVolumeCount para consultar el número de volúmenes del conjunto de instantáneas. A continuación, llame al método CVssWriter::GetCurrentVolumeArray para enumerar los nombres originales de los volúmenes del conjunto de instantáneas.

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 vswriter.h (incluya Vss.h, VsWriter.h)
Library VssApi.lib