Função ClusterGetVolumePathName (resapi.h)

[ClusterGetVolumePathName está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use GetVolumePathName.]

Recupera o ponto de montagem de volume no cluster em que o caminho especificado está montado.

Sintaxe

BOOL ClusterGetVolumePathName(
  [in]  LPCWSTR lpszFileName,
  [out] LPWSTR  lpszVolumePathName,
  [in]  DWORD   cchBufferLength
);

Parâmetros

[in] lpszFileName

Um ponteiro para a cadeia de caracteres do caminho de entrada. Nomes de arquivo e diretório absolutos e relativos, por exemplo "..", são aceitáveis nesse caminho.

Se você especificar um diretório relativo ou um nome de arquivo sem um qualificador de volume, ClusterGetVolumePathName retornará a letra da unidade do volume atual.

Se esse parâmetro for uma cadeia de caracteres vazia, "", a função falhará, mas o último erro será definido como ERROR_SUCCESS.

[out] lpszVolumePathName

Um ponteiro para uma cadeia de caracteres que recebe o ponto de montagem de volume para o caminho de entrada.

[in] cchBufferLength

O comprimento do buffer de saída, em WCHARs.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os exemplos a seguir podem ajudar. Nestes exemplos, "Filename.Ext" existe, mas "Path\that\does\not\exist" não existe.

  • Entrada: "C:\ClusterStorage\Volume31\Filename.Ext"

    Saída: "C:\ClusterStorage\Volume31"

  • Entrada: "\\?\C:\ClusterStorage\Volume31\Filename.Ext"

    Saída: "\?\C:\ClusterStorage\Volume31"

  • Entrada: "C:\ClusterStorage\Volume31\Path\that\does\not\exist"

    Saída: "C:\ClusterStorage\Volume31"

  • Entrada: "\\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\Filename.Ext"

    Saída: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31"

  • Entrada: "\\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\Filename.Ext"

    Saída: "\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31"

  • Entrada: "\\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\Filename.Ext"

    Saída: "\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31"

Windows Server 2008 R2: A versão inicial de ResApi.h que contém a função ClusterGetVolumePathName usou tipos de dados baseados em TCHAR em vez de tipos de dados baseados em WCHAR. O pré-processador UNICODE deve ser definido antes que ResApi.h seja incluído. 
#define UNICODE 1
#include <ResApi.h>

A função ClusterGetVolumePathName deve ser chamada de um nó do cluster.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter
Plataforma de Destino Windows
Cabeçalho resapi.h
Biblioteca ResUtils.Lib
DLL ResUtils.Dll

Confira também

Fazendo backup e restaurando a configuração do cluster de failover usando o VSS

Funções de backup e restauração

  • Last updated on