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 不支援磁碟區管理功能。

例子

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

要求

另請參閱

掛接的資料夾

磁碟區管理功能