IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths-Methode (vsbackup.h)
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 |
|---|---|
|
Die Pfadinformationen wurden erfolgreich zurückgegeben. |
|
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) |