_splitpath_s， _wsplitpath_s

项目
02/21/2013

将路径名元素。这些是 _splitpath， _wsplitpath 的版本与安全增强的 CRT中的安全功能如中所述。

errno_t _splitpath_s(
   const char * path,
   char * drive,
   size_t driveNumberOfElements,
   char * dir,
   size_t dirNumberOfElements,
   char * fname,
   size_t nameNumberOfElements,
   char * ext, 
   size_t extNumberOfElements
);
errno_t _wsplitpath_s(
   const wchar_t * path,
   wchar_t * drive,
   size_t driveNumberOfElements,
   wchar_t *dir,
   size_t dirNumberOfElements,
   wchar_t * fname,
   size_t nameNumberOfElements,
   wchar_t * ext,
   size_t extNumberOfElements
);
template <size_t drivesize, size_t dirsize, size_t fnamesize, size_t extsize>
errno_t _splitpath_s(
   const char *path,
   char (&drive)[drivesize],
   char (&dir)[dirsize],
   char (&fname)[fnamesize],
   char (&ext)[extsize]
); // C++ only
template <size_t drivesize, size_t dirsize, size_t fnamesize, size_t extsize>
errno_t _wsplitpath_s(
   const wchar_t *path,
   wchar_t (&drive)[drivesize],
   wchar_t (&dir)[dirsize],
   wchar_t (&fname)[fnamesize],
   wchar_t (&ext)[extsize]
); // C++ only

参数

[in] path
完整路径。
[out] drive
驱动器号，后跟冒号 (:)。，如果不需要驱动器号，可以将该参数的 NULL 。
[in] driveNumberOfElements
drive 缓冲区的大小在单字节或宽字符的。如果 drive 是 NULL，此值必须为 0。
[out] dir
目录路径，包括尾部的反斜杠。可以使用斜杠 ( /)，杠 ( \ )，或者两个。，如果不需要目录路径，可以将该参数的 NULL 。
[in] dirNumberOfElements
dir 缓冲区的大小在单字节或宽字符的。如果 dir 是 NULL，此值必须为 0。
[out] fname
基文件名 (不带扩展名)。，如果不需要文件名，可以将该参数的 NULL 。
[in] nameNumberOfElements
fname 缓冲区的大小在单字节或宽字符的。如果 fname 是 NULL，此值必须为 0。
[out] ext
文件扩展名，包括驱动的句点 (.)。，如果不需要文件扩展名，可以将该参数的 NULL 。
[in] extNumberOfElements
ext 缓冲区的大小在单字节或宽字符的。如果 ext 是 NULL，此值必须为 0。

返回值

零，如果成功;在失败的错误代码。

错误状态

Condition	返回值
path 是NULL	EINVAL
drive 是 NULL， driveNumberOfElements 是非零	EINVAL
drive 非NULL， driveNumberOfElements 为零	EINVAL
dir 是 NULL， dirNumberOfElements 是非零	EINVAL
dir 非NULL， dirNumberOfElements 为零	EINVAL
fname 是 NULL， nameNumberOfElements 是非零	EINVAL
fname 非NULL， nameNumberOfElements 为零	EINVAL
ext 是 NULL， extNumberOfElements 是非零	EINVAL
ext 非NULL， extNumberOfElements 为零	EINVAL

如果任何一个以上条件，则无效参数调用处理程序，如参数验证所述。如果执行允许继续，对 EINVAL 的这些功能集 errno 和返回 EINVAL。

如果任何缓冲区太短而无法包含该结果，这些功能清除所有缓冲区空字符串，设置 errno 到 ERANGE，并返回 ERANGE。

备注

_splitpath_s功能将路径其四个元素。自动**_splitpath_s**处理多字节字符串参数根据需要，识别多字节字符顺序基于当前正在使用多字节代码的页。 _wsplitpath_s是 _splitpath_s的宽字符版本;为 _wsplitpath_s的参数是宽字符字符串。这些函数或方法的行为

一般文本例程映射