Metodo IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)

Normalizza un percorso di volume locale o un percorso di condivisione UNC in modo che possa essere passato al metodo IVssBackupComponents::AddToSnapshotSet .

Sintassi

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

Parametri

[in] pwszFilePath

Percorso da normalizzare.

[out] ppwszRootPath

Riceve il percorso radice che deve essere passato al metodo IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Se pwszFilePath è un percorso locale, questo parametro riceve il nome GUID del volume. Se si tratta di un percorso UNC, questo parametro riceve un percorso di condivisione completamente valutato.

[in, optional] bNormalizeFQDNforRootPath

Se pwszFilePath è un percorso di condivisione UNC, la parte del nome del server può essere

• Un nome host
• Un nome di dominio completo
• Un indirizzo IP

Questo parametro specifica se il formato del nome host o il formato del nome di dominio completo deve essere utilizzato nella parte del nome del server del percorso radice normalizzato restituito nel parametro ppwszRootPath .

Se questo parametro è FALSE, verrà usato il formato del nome host semplice.

Il valore predefinito per questo parametro è FALSE.

Se questo parametro è TRUE, verrà usato il nome di dominio completo.

In una distribuzione in cui un nome host può esistere in più suffissi di dominio, questo parametro deve essere TRUE.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Commenti

Questo metodo normalizza un percorso del volume locale o un percorso di condivisione UNC e lo separa in un percorso radice e in un percorso di prefisso logico. Il percorso radice può quindi essere passato al metodo IVssBackupComponents::AddToSnapshotSet .

Se pwszFilePath è un percorso del volume locale, il percorso radice sarà simile a un punto di montaggio del volume. In questo caso, i percorsi radice e dei prefissi logici vengono mappati rispettivamente ai risultati di GetVolumePathName e GetVolumeNameForVolumeMountPoint.

Se pwszFilePath è un percorso di condivisione UNC, i percorsi dei prefissi radice e logici vengono mappati rispettivamente al percorso radice della condivisione file e al percorso di condivisione fisica completamente valutato (che prenderà in considerazione rispettivamente DFS e distribuzione del cluster).

Se si chiama questo metodo più volte per la stessa operazione di creazione del set di copie shadow, è necessario impostare bNormalizeFQDNforRootPath sullo stesso valore per ogni chiamata. Il formato del nome di dominio completo e il formato del nome host non possono essere misti nello stesso set di copie shadow.

Requisiti

Vedi anche

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4