getLongPathNameTransactedA 函式 (winbase.h)

  • 發行項

[Microsoft 強烈建議開發人員利用替代方法來達成應用程式的需求。 許多針對 TxF 開發的案例，都可以透過更簡單且更容易取得的技術來達成。 此外，未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊，以及 TxF 的替代方案，請參閱 使用交易式 NTFS 的替代方案。]

將指定的路徑轉換為其長格式做為交易作業。

若要在沒有交易的情況下執行這項作業，請使用 GetLongPathName 函式。

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

語法

DWORD GetLongPathNameTransactedA(
  [in]  LPCSTR lpszShortPath,
  [out] LPSTR  lpszLongPath,
  [in]  DWORD  cchBuffer,
  [in]  HANDLE hTransaction
);

參數

[in] lpszShortPath

要轉換的路徑。

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

提示

從 Windows 10 版本 1607 開始，您可以選擇移除MAX_PATH限制，而不需在前面加上 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節。

路徑必須位於本機計算機上;否則，函式會失敗，並將最後一個錯誤碼設定為 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE。

[out] lpszLongPath

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

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

[in] cchBuffer

緩衝區 lpszLongPath 的大小會指向 TCHARs 中的 。

[in] hTransaction

交易的句柄。 CreateTransaction 函式會傳回此句柄。

傳回值

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

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

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

備註

在許多文件系統上，簡短檔名包含一個波浪 (~) 字元。 不過，並非所有文件系統都遵循此慣例。 因此，如果路徑不包含磚 (~) 字元，請勿假設您可以略過呼叫 GetLongPathNameTransacted 。

如果找不到長路徑，此函式會傳回 lpszLongPath 參數中 lpszShortPath 參數中指定的名稱。

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

注意 雖然此案例中的傳回值是包含終止 Null 字元的長度，但成功時的傳回值不包含計數中的終止 Null 字元。
 
您可以存取檔案或目錄，但無法存取該檔案或目錄的某些父目錄。 因此， 當 GetLongPathNameTransacted 無法查詢路徑元件的父目錄，以判斷該元件的完整名稱時，GetLongPathNameTransacted 可能會失敗。 對於擴展名超過 3 個字元的目錄元件，或長度總計超過 12 個字元，可以略過這項檢查。 如需詳細資訊，請參閱命名檔案、路徑和命名空間的簡短與長名稱一節。

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

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) No
 

SMB 3.0 不支援 TxF。

注意

winbase.h 標頭會將 GetLongPathNameTransacted 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

GetFullPathNameTransacted

GetShortPathName

命名檔案、路徑和命名空間

交易式 NTFS