共用方式為

GetVolumePathNamesForVolumeNameW 函式 （fileapi.h）

  • 發行項

擷取指定磁碟區驅動器號和掛接的資料夾路徑清單。

語法

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

參數

[in] lpszVolumeName

磁碟區 磁碟區 路徑的 GUID。 磁碟區 GUID 路徑的格式為 “\\？\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxx}\”。

[out] lpszVolumePathNames

緩衝區的指標，接收驅動器號和掛接的資料夾路徑清單。 此清單是以 null 結尾字串的陣列，由其他 NULL 字元終止。 如果緩衝區不夠大而無法保存完整清單，則緩衝區會盡可能保留清單的大部分。

[in] cchBufferLength

WCHAR中 lpszVolumePathNames 緩衝區的長度，包括所有 NULL 字元。

[out] lpcchReturnLength

如果呼叫成功，此參數就是複製到 lpszVolumePathNames 緩衝區 WCHAR 數目。 否則，此參數是儲存完整清單所需的緩衝區大小，WCHAR。

傳回值

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

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 如果緩衝區不夠大而無法保存完整清單，錯誤碼會 ERROR_MORE_DATA，而且 lpcchReturnLength 參數會收到所需的緩衝區大小。

言論

在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能。

科技 支援
伺服器消息塊 （SMB） 3.0 通訊協定 不
SMB 3.0 透明故障轉移 （TFO） 不
具有向外延展檔案共用的SMB 3.0（SO） 不
叢集共用磁碟區檔案系統 （CsvFS） 是的
復原檔案系統 （ReFS） 是的
 

SMB 不支援磁碟區管理功能。

例子

如需範例，請參閱 顯示磁碟區路徑。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 fileapi.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

掛接的資料夾

磁碟區管理功能