术语 | getvolumepathnamesforvolumename |
释义 | GetVolumePathNamesForVolumeName 语法: C++ BOOL WINAPI GetVolumePathNamesForVolumeName( __in LPCTSTR lpszVolumeName, __out LPTSTR lpszVolumePathNames, __in DWORD cchBufferLength, __out PDWORD lpcchReturnLength ); GetVolumePathNamesForVolumeName功能 检索的驱动器号和数量清单的GUID为指定的卷路径。 有关卷GUID的路径信息,请参见命名文件或目录。 参数 lpszVolumeName [in] 阿卷GUID该卷的路径。阿卷GUID路径的形式为“\\ \\?\\的Volume(GUID)\\”其中GUID是一个GUID标识量。 lpszVolumePathNames [out] 阿一个缓冲区,它接收的驱动器号和卷GUID路径列表指针。这份名单是一个空数组,终止了额外的空字符结尾的字符串。如果缓冲区不够大,无法保存的完整列表,缓冲区认为,作为名单尽可能多。 cchBufferLength [in] 该lpszVolumePathNames缓冲区的长度,在TCHARs,包括所有NULL字符。 lpcchReturnLength [out] 如果调用成功,这个参数是复制到lpszVolumePathNames缓冲区TCHARs数目。否则,这个参数是需要保存的完整列表,缓冲区大小TCHARs。 返回值 如果函数成功,返回值为非零。 如果函数失败,返回值是零。为了获得更多错误信息,调用GetLastError。如果缓冲区不够大,保存完整列表,错误代码是ERROR_MORE_DATA和lpcchReturnLength参数接收所需的缓冲区大小。 备注 要编译的应用程序使用此函数,定义为0x0501或更高_WIN32_WINNT宏。有关详细信息,请参阅使用Windows头。 实例 有关示例,请参见显示音量路径。 要求: 最低支持client-Windows XP 最低支持serverWindows服务器2003 HeaderWinBase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll Unicode和ANSI namesGetVolumePathNamesForVolumeNameW(Unicode)和GetVolumePathNamesForVolumeNameA(ANSI)的 参见 卷管理功能 安装文件夹 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年9月3日 ==英文原文==GetVolumePathNamesForVolumeName Function Retrieves a list of drive letters and volume GUID paths for the specified volume. For more information about volume GUID paths, see Naming a File or Directory . Syntax C++ BOOL WINAPI GetVolumePathNamesForVolumeName( __in LPCTSTR lpszVolumeName, __out LPTSTR lpszVolumePathNames, __in DWORD cchBufferLength, __out PDWORD lpcchReturnLength ); Parameters lpszVolumeName [in] A volume GUID path for the volume. A volume GUID path is of the form "\\\\?\\Volume{GUID}\\" where GUID is a GUID that identifies the volume. lpszVolumePathNames [out] A pointer to a buffer that receives the list of drive letters and volume GUID paths. The list is an array of null-terminated strings terminated by an additional NULL character. If the buffer is not large enough to hold the complete list, the buffer holds as much of the list as possible. cchBufferLength [in] The length of the lpszVolumePathNames buffer, in TCHARs, including all NULL characters. lpcchReturnLength [out] If the call is successful, this parameter is the number of TCHARs copied to the lpszVolumePathNames buffer. Otherwise, this parameter is the size of the buffer required to hold the complete list, in TCHARs. Return Value If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError . If the buffer is not large enough to hold the complete list, the error code is ERROR_MORE_DATA and the lpcchReturnLength parameter receives the required buffer size. Remarks To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0501 or later. For more information, see Using the Windows Headers . Examples For an example, see Displaying Volume Paths . Requirements Minimum supported clientWindows XP Minimum supported serverWindows Server 2003 HeaderWinBase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll Unicode and ANSI namesGetVolumePathNamesForVolumeNameW (Unicode) and GetVolumePathNamesForVolumeNameA (ANSI) See Also Volume Management Functions Mounted Folders Send comments about this topic to Microsoft Build date: 9/3/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa364998(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。