GetLongPathNameW 函式 （fileapi.h）

將指定的路徑轉換成其長格式。

若要以交易作業的形式執行這項作業，請使用 GetLongPathNameTransacted 函式。

如需檔案和路徑名稱的詳細資訊，請參閱 命名檔案、路徑和命名空間。

語法

DWORD GetLongPathNameW(
  [in]  LPCWSTR lpszShortPath,
  [out] LPWSTR  lpszLongPath,
  [in]  DWORD   cchBuffer
);

參數

[in] lpszShortPath

要轉換的路徑。

根據預設，名稱限製為MAX_PATH個字元。 若要將此限制延伸至 32,767 寬字元，請在路徑前面加上 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間。

[out] lpszLongPath

要接收長路徑之緩衝區的指標。

您可以使用用於 lpszShortPath 參數的相同緩衝區。

[in] cchBuffer

緩衝區大小 lpszLongPath 指向 ，TCHAR。

傳回值

如果函式成功，傳回值會是複製到 lpszLongPath之字串的長度，TCHAR，不包含終止的 null 字元。

如果 lpBuffer 緩衝區太小而無法包含路徑，則傳回值會是大小，以 TCHAR為保留路徑和終止 Null 字元所需的緩衝區。

如果函式因任何其他原因而失敗，例如檔案不存在，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

在許多檔案系統上，簡短的檔名包含一個並排字元（~） 字元。 不過，並非所有文件系統都遵循此慣例。 因此，如果路徑不包含tilde （~） 字元，請勿假設您可以略過呼叫 getLongPathName 。

如果檔案或目錄存在但找不到長路徑，GetLongPathName 成功，將 lpszShortPath 參數所參考的字串複製到 lpszLongPath 參數所參考的緩衝區。

如果傳回值大於 cchBuffer中指定的值，您可以使用足以保存路徑的緩衝區再次呼叫 函式。 如需此案例的範例，請參閱 getFullPathName範例程式代碼一節。