Compartilhar via

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

  • Artigo

Normaliza um caminho de volume local ou caminho de compartilhamento UNC para que ele possa ser passado para o método IVssBackupComponents::AddToSnapshotSet .

Sintaxe

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

Parâmetros

[in] pwszFilePath

O caminho a ser normalizado.

[out] ppwszRootPath

Recebe o caminho raiz que deve ser passado para o método IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Se pwszFilePath for um caminho local, esse parâmetro receberá o nome guid do volume. Se for um caminho UNC, esse parâmetro receberá um caminho de compartilhamento totalmente avaliado.

[in, optional] bNormalizeFQDNforRootPath

Se pwszFilePath for um caminho de compartilhamento UNC, a parte do nome do servidor poderá ser

  • Um nome de host
  • Um nome de domínio totalmente qualificado
  • Um endereço IP

Esse parâmetro especifica se o formato do nome do host ou o formato de nome de domínio totalmente qualificado devem ser usados na parte do nome do servidor do caminho raiz normalizado retornado no parâmetro ppwszRootPath .

Se esse parâmetro for FALSE, o formato de nome de host simples será usado.

O valor padrão para esse parâmetro é FALSE.

Se esse parâmetro for TRUE, o nome de domínio totalmente qualificado será usado.

Em uma implantação em que um nome de host pode existir em vários sufixos de domínio, esse parâmetro deve ser TRUE.

Valor retornado

Veja a seguir os códigos de retorno válidos para esse método.

Código de retorno Descrição
S_OK
 Retornou com êxito as informações do caminho.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.

Comentários

Esse método normaliza um caminho de volume local ou caminho de compartilhamento UNC e o separa em um caminho raiz e um caminho de prefixo lógico. O caminho raiz pode ser passado para o método IVssBackupComponents::AddToSnapshotSet .

Se pwszFilePath for um caminho de volume local, o caminho raiz será semelhante a um ponto de montagem de volume. Nesse caso, os caminhos de prefixo lógico e raiz são mapeados para os resultados de GetVolumePathName e GetVolumeNameForVolumeMountPoint, respectivamente.

Se pwszFilePath for um caminho de compartilhamento UNC, os caminhos de prefixo lógico e raiz serão mapeados para o caminho raiz do compartilhamento de arquivos e o caminho de compartilhamento físico totalmente avaliado (que levará em conta o DFS e a implantação do cluster), respectivamente.

Se você chamar esse método mais de uma vez para a mesma operação de criação do conjunto de cópias de sombra, deverá definir bNormalizeFQDNforRootPath com o mesmo valor para cada chamada. O formato de nome de domínio totalmente qualificado e o formato de nome de host não podem ser misturados no mesmo conjunto de cópias de sombra.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)

Confira também

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4