Compartir a través de

Método IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)

  • Artículo

Normaliza una ruta de acceso de volumen local o una ruta de acceso de recurso compartido UNC para que se pueda pasar al método IVssBackupComponents::AddToSnapshotSet .

Sintaxis

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

Parámetros

[in] pwszFilePath

Ruta de acceso que se va a normalizar.

[out] ppwszRootPath

Recibe la ruta de acceso raíz que se debe pasar al método IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Si pwszFilePath es una ruta de acceso local, este parámetro recibe el nombre guid del volumen. Si es una ruta de acceso UNC, este parámetro recibe una ruta de acceso de recurso compartido totalmente evaluada.

[in, optional] bNormalizeFQDNforRootPath

Si pwszFilePath es una ruta de acceso de recurso compartido UNC, la parte del nombre del servidor puede ser

  • Un nombre de host
  • Nombre de dominio completo.
  • Una dirección IP

Este parámetro especifica si se debe usar el formato de nombre de host o el formato de nombre de dominio completo en la parte del nombre del servidor de la ruta de acceso raíz normalizada que se devuelve en el parámetro ppwszRootPath .

Si este parámetro es FALSE, se usará el formato de nombre de host simple.

El valor predeterminado de este parámetro es FALSE.

Si este parámetro es TRUE, se usará el nombre de dominio completo.

En una implementación en la que un nombre de host podría existir en varios sufijos de dominio, este parámetro debe ser TRUE.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Código devuelto Descripción
S_OK
 Devolvió correctamente la información de la ruta de acceso.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.

Comentarios

Este método normaliza una ruta de acceso de volumen local o una ruta de acceso de recurso compartido UNC y la separa en una ruta de acceso raíz y una ruta de acceso de prefijo lógico. A continuación, la ruta de acceso raíz se puede pasar al método IVssBackupComponents::AddToSnapshotSet .

Si pwszFilePath es una ruta de acceso de volumen local, la ruta de acceso raíz será similar a un punto de montaje de volumen. En este caso, las rutas de acceso raíz y de prefijo lógico se asignan a los resultados de GetVolumePathName y GetVolumeNameForVolumeMountPoint, respectivamente.

Si pwszFilePath es una ruta de acceso de recurso compartido UNC, las rutas de acceso del prefijo raíz y lógico se asignan a la ruta de acceso raíz del recurso compartido de archivos y la ruta de acceso al recurso compartido físico totalmente evaluada (que tendrá en cuenta la implementación de DFS y del clúster), respectivamente.

Si llama a este método más de una vez para la misma operación de creación del conjunto de instantáneas, debe establecer bNormalizeFQDNforRootPath en el mismo valor para cada llamada. El formato de nombre de dominio completo y el formato de nombre de host no se pueden mezclar en el mismo conjunto de instantáneas.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)

Consulte también

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4