通过

GetTempPathA 函数 （fileapi.h）

  • 项目

检索为临时文件指定的目录的路径。

语法

DWORD GetTempPathA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

参数

[in] nBufferLength

由 lpBuffer标识的字符串缓冲区的大小，TCHAR。

[out] lpBuffer

指向字符串缓冲区的指针，该缓冲区接收指定临时文件路径的以 null 结尾的字符串。 返回的字符串以反斜杠结尾，例如“C：\TEMP\”。

返回值

如果函数成功，则返回值为复制到 lpBuffer的字符串的长度（TCHAr，不包括终止 null 字符）。 如果返回值大于 nBufferLength，则返回值为保留路径所需的缓冲区的长度（TCHAR）。

如果函数失败，则返回值为零。 若要获取扩展的错误信息，请调用 GetLastError。

最大可能的返回值为 MAX_PATH+1 （261）。

言论

注意

应用应调用 GetTempPath2，而不是 GetTempPath。

GetTempPath 函数按以下顺序检查是否存在环境变量，并使用找到的第一个路径：

  1. TMP 环境变量指定的路径。
  2. TEMP 环境变量指定的路径。
  3. USERPROFILE 环境变量指定的路径。
  4. Windows 目录。
请注意，该函数不验证路径是否存在，也不会测试当前进程是否对路径具有任何类型的访问权限。 GetTempPath 函数返回格式正确的字符串，该字符串根据前面指定的环境变量搜索顺序指定完全限定的路径。 在对文件 I/O 操作使用之前，应用程序应验证路径是否存在以及对路径的充分访问权限。

符号链接行为 - 如果路径指向符号链接，临时路径名称将维护任何符号链接。

在 Windows 8 和 Windows Server 2012 中，以下技术支持此函数。

科技 支持
服务器消息块 （SMB） 3.0 协议 是的
SMB 3.0 透明故障转移 （TFO） 是的
具有横向扩展文件共享的 SMB 3.0 （SO） 是的
群集共享卷文件系统 （CsvFS） 是的
可复原文件系统 （ReFS） 是的
 

例子

有关示例，请参阅 创建和使用临时文件。

注意

fileapi.h 标头将 GetTempPath 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2003 [桌面应用 |UWP 应用]
目标平台 窗户
标头 fileapi.h （包括 Windows.h）
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

文件管理功能

GetTempFileName

符号链接