共用方式為

ClusterGetVolumePathName 函式 (resapi.h)

  • 發行項

[ClusterGetVolumePathName 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 GetVolumePathName。]

擷取叢集上掛接指定路徑的磁碟區裝入點。

語法

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

參數

[in] lpszFileName

輸入路徑字串的指標。 絕對和相對檔案和目錄名稱，例如 “..”，在此路徑中都是可接受的。

如果您指定沒有磁碟區限定符的相對目錄或檔名， ClusterGetVolumePathName 會傳回目前磁碟區的驅動器號。

如果此參數是空字串 “”，則函式會失敗，但最後一個錯誤會設定為 ERROR_SUCCESS。

[out] lpszVolumePathName

接收輸入路徑之磁碟區裝入點之字串的指標。

[in] cchBufferLength

WCHAR 中輸出緩衝區的長度。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

下列範例可能有所説明。 在這些範例中，“Filename.Ext” 不存在，但 “Path\that\does\not\exist” 不存在。

  • 輸入：“C：\ClusterStorage\Volume31\Filename.Ext”

    輸出：“C：\ClusterStorage\Volume31”

  • 輸入：“\\？\C：\ClusterStorage\Volume31\Filename.Ext”

    輸出：“\？\C：\ClusterStorage\Volume31”

  • 輸入：“C：\ClusterStorage\Volume31\Path\that\does\not\exist”

    輸出：“C：\ClusterStorage\Volume31”

  • 輸入：“\\？\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\Filename.Ext”

    輸出：“\？\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31”

  • 輸入：“\\？\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\Filename.Ext”

    輸出：“\？\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31”

  • 輸入：“\\？\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\Filename.Ext”

    輸出：“\？\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31”

Windows Server 2008 R2： 包含 ClusterGetVolumePathName 函式的 ResApi.h 初始版本使用 TCHAR 型數據類型，而不是 WCHAR 型數據類型。 必須設定 UNICODE 預處理器定義，才能包含 ResApi.h。 
#define UNICODE 1
#include <ResApi.h>

ClusterGetVolumePathName 函式必須從叢集的節點呼叫。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 Enterprise、Windows Server 2008 R2 Datacenter
目標平台 Windows
標頭 resapi.h
程式庫 ResUtils.Lib
Dll ResUtils.Dll

另請參閱

使用 VSS 備份和還原故障轉移叢集設定

備份與還原函式