IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths-Methode (vsbackup.h)

  • Artikel

Normalisiert einen lokalen Volumepfad oder UNC-Freigabepfad, sodass er an die IVssBackupComponents::AddToSnapshotSet-Methode übergeben werden kann.

Syntax

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

Parameter

[in] pwszFilePath

Der zu normalisierende Pfad.

[out] ppwszRootPath

Empfängt den Stammpfad, der an die IVssBackupComponents::AddToSnapshotSet-Methode übergeben werden soll.

[out] ppwszLogicalPrefix

Wenn pwszFilePath ein lokaler Pfad ist, empfängt dieser Parameter den Namen der Volume-GUID. Wenn es sich um einen UNC-Pfad handelt, empfängt dieser Parameter einen vollständig ausgewerteten Freigabepfad.

[in, optional] bNormalizeFQDNforRootPath

Wenn pwszFilePath ein UNC-Freigabepfad ist, kann der Servername-Teil sein.

  • Hostname
  • Ein Vollqualifizierter Domänenname
  • Eine IP-Adresse

Dieser Parameter gibt an, ob das Hostnamenformat oder das vollqualifizierte Domänennamenformat im Servernamenteil des normalisierten Stammpfads verwendet werden soll, der im ppwszRootPath-Parameter zurückgegeben wird.

Wenn dieser Parameter FALSE ist, wird ein einfaches Hostnamenformat verwendet.

Der Standardwert für diesen Parameter ist FALSE.

Wenn dieser Parameter TRUE ist, wird der vollqualifizierte Domänenname verwendet.

In einer Bereitstellung, in der ein Hostname in mehreren Domänensuffixen vorhanden sein könnte, sollte dieser Parameter TRUE sein.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Rückgabecode BESCHREIBUNG
S_OK
 Die Pfadinformationen wurden erfolgreich zurückgegeben.
E_OUTOFMEMORY
 Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.

Hinweise

Diese Methode normalisiert einen lokalen Volumepfad oder UNC-Freigabepfad und trennt ihn in einen Stammpfad und einen logischen Präfixpfad. Der Stammpfad kann dann an die IVssBackupComponents::AddToSnapshotSet-Methode übergeben werden.

Wenn pwszFilePath ein lokaler Volumepfad ist, ähnelt der Stammpfad einem Volumebereitstellungspunkt. In diesem Fall werden die Stamm- und die logischen Präfixpfade den Ergebnissen von GetVolumePathName bzw . GetVolumeNameForVolumeMountPoint zugeordnet.

Wenn pwszFilePath ein UNC-Freigabepfad ist, werden die Stamm- und logischen Präfixpfade dem Stammpfad der Dateifreigabe und dem vollständig ausgewerteten physischen Freigabepfad zugeordnet (wobei die DFS- bzw. Clusterbereitstellung berücksichtigt wird).

Wenn Sie diese Methode mehrmals für denselben Vorgang zum Erstellen eines Schattenkopiersatzes aufrufen, müssen Sie bNormalizeFQDNforRootPath für jeden Aufruf auf den gleichen Wert festlegen. Vollqualifiziertes Domänennamenformat und Hostnamenformat können nicht im gleichen Schattenkopiersatz gemischt werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h)

Weitere Informationen

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4