Método IVssBackupComponents::AddToSnapshotSet (vsbackup.h)
El método AddToSnapshotSet agrega un volumen original o un recurso compartido de archivos remoto original al conjunto de instantáneas.
Sintaxis
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Parámetros
[in] pwszVolumeName
Cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen o la ruta de acceso UNC del recurso compartido de archivos remoto que se va a copiar de forma instantánea. El nombre o la ruta de acceso UNC deben tener uno de los siguientes formatos y deben 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 con el formato \\?\Volume{GUID}\ (donde GUID identifica el volumen)
- Ruta de acceso UNC que especifica un recurso compartido de archivos remoto, por ejemplo, \\Clusterx\Share1\
[in] ProviderId
Proveedor que se va a usar. GUID_NULL se puede usar, en cuyo caso se usará el proveedor predeterminado.
[out] pidSnapshot
Identificador devuelto de la instantánea agregada.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se agregó correctamente el volumen o el recurso compartido de archivos remotos al conjunto de instantáneas. |
|
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un 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. |
|
Se ha agregado al conjunto de instantáneas el número máximo de volúmenes o recursos compartidos de archivos remotos. El volumen o recurso compartido de archivos remoto especificado no se agregó al conjunto de instantáneas. |
|
El volumen o recurso compartido de archivos remotos se ha agregado al número máximo de conjuntos de instantáneas. El volumen o recurso compartido de archivos remoto especificado no se agregó al conjunto de instantáneas. |
|
El volumen especificado se anida demasiado para participar en la operación de VSS. Entre los posibles motivos de este error se incluyen los siguientes:
|
|
pwszVolumeName no corresponde a un volumen existente ni a un recurso compartido de archivos remoto. |
|
ProviderId no corresponde a un proveedor registrado. |
|
Error de proveedor esperado. El proveedor registró el error en el registro de eventos. Para obtener más información, vea Control de eventos y errores en VSS. |
|
Otra creación de instantáneas ya está en curso. Se produce al agregar un volumen CSV a un conjunto de instantáneas de varios nodos al mismo tiempo o al agregar un recurso compartido de escalabilidad horizontal al conjunto de instantáneas de varios nodos de cliente SMB al mismo tiempo. |
|
El valor del parámetro ProviderId es GUID_NULL y ningún proveedor de VSS indica que admite el volumen especificado o el recurso compartido de archivos remoto. |
|
El proveedor especificado no admite el volumen o el recurso compartido de archivos remoto. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea 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. |
|
El proveedor devolvió un código de error inesperado. Este código de error solo se devuelve a través del método QueryStatus en la interfaz IVssAsync devuelta en el parámetro ppAsync . |
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.
Si pwszVolumeName es una ruta de acceso del recurso compartido UNC, la parte del nombre del servidor debe estar en formato de nombre de host o nombre de dominio completo. Los nombres de recurso compartido UNC con direcciones IP deben normalizarse llamando al método IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths antes de pasarlos a AddToSnapshotSet.
El número máximo de volúmenes con instantáneas en un único conjunto de instantáneas es 64.
Si ProviderId es GUID_NULL, el proveedor predeterminado se selecciona según el algoritmo siguiente:
- Si algún proveedor de hardware admite el volumen especificado o el recurso compartido de archivos remoto, se selecciona ese proveedor.
- Si no hay ningún proveedor de hardware disponible, si algún proveedor de software admite el volumen especificado, se selecciona.
- Si no hay ningún proveedor de hardware o proveedor de software disponible, se selecciona el proveedor del sistema. (Solo hay un proveedor de sistema preinstalado, que debe admitir todos los volúmenes locales no extraíbles).
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admiten discos duros virtuales.
El identificador de instantánea que se devuelve en el parámetro pidSnapshot se almacena en el documento componentes de copia de seguridad. Sin embargo, no hay ningún método para consultar esta información y es posible que el autor de la llamada tenga que almacenarla para que se pueda usar durante la restauración.
Requisitos
| Requisito | Value |
|---|---|
| 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 |