|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetShortPathName
The GetShortPathName function obtains the short path form of a specified input path.
DWORD GetShortPathName(
LPCTSTR lpszLongPath, // points to a null-terminated path string LPTSTR lpszShortPath, // points to a buffer to receive the null-terminated short form of the path DWORD cchBuffer // specifies the size of the buffer pointed to by lpszShortPath );
Parameters
lpszLongPath
Points to a null-terminated path string. The function obtains the short form of this path.
lpszShortPath
Points to a buffer to receive the null-terminated short form of the path specified by lpszLongPath.
cchBuffer
Specifies the size, in characters, of the buffer pointed to by lpszShortPath.
Return Values
If the function succeeds, the return value is the length, in characters, of the string copied to lpszShortPath, not including the terminating null character. If the function fails due to the lpszShortPath buffer being too small to contain the short path string, the return value is the size, in characters, of the short path string. You need to call the function with a short path buffer that is at least as large as the short path string. If the function fails for any other reason, the return value is zero. To get extended error information, call GetLastError.
Remarks
When an application calls this function and specifies a path on a volume that does not support 8.3 aliases, the function fails with ERROR_INVALID_PARAMETER if the path is longer than 67 bytes. The path specified by lpszLongPath does not have to be a fully qualified path or a long path. The short form may be longer than the specifed path. If the specified path is already in its short form, there is no need for any conversion, and the function simply copies the specified path to the buffer for the short path.
You can set lpszShortPath to the same value as lpszLongPath; in other words, you can set the buffer for the short path to the address of the input path string. You can obtain the long name of a file from the short name by calling the FindFirstFile function.
See Also
GetFullPathName, FindFirstFile
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetShortPathName
Функция GetShortPathName получает короткую форму пути определенного входного пути.
DWORD GetShortPathName(
LPCTSTR lpszLongPath, // ТОЧКИ на недействительный расторгнутую строку пути LPTSTR lpszShortPath, // точки на буфер, чтобы получать недействительный расторгнутую короткую форму пути DWORD cchBuffer // определяет размер буфера указанного, чтобы lpszShortPath );
Параметры
lpszLongPath
Точки на недействительный расторгнутую строку пути. Функция получает короткую форму этого пути.
lpszShortPath
Точки на буфер, чтобы получать недействительный расторгнутую короткую форму пути определенного lpszLongPath.
cchBuffer
Определяет размер, в символах, буфера указанного, чтобы lpszShortPath.
Обратные Величины
Если функция добивается успеха, обратная величина является длиной, в символах, строки скопированной на lpszShortPath, не включая завершающий недействительный символ. Если функция терпит неудачу из-за буфера lpszShortPath слишком небольшой, чтобы содержать короткую строку пути, обратная величина является размером, в символах, короткой строки пути. Вам нужно называть функцию с коротким буфером пути, который по крайней мере такой же большой как короткая строка пути. Если функция терпит неудачу по любой другой причине, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.
Замечания
Когда приложение называет эту функцию и определяет путь в объеме, что не поддерживает 8.3 псевдонимов, функция терпит неудачу с ERROR_INVALID_PARAMETER если путь более длинный чем 67 байтов. Путь определенный lpszLongPath нет должен быть полностью пригодным путем или длинный путь. Короткая форма может быть более длинной чем specifed путь. Если определенный путь - уже в своей короткой форме, нет необходимости для любого преобразования, и функция просто копирует определенный путь в буфер для короткого пути.
Вы можете установить lpszShortPath в ту же величину как lpszLongPath; другими словами, Вы можете установить буфер для короткого пути по адресу входной строки пути. Вы можете получить длинное имя файла из короткого имени вызывая функцию FindFirstFile.
Смотри Также
GetFullPathName, FindFirstFile
|
|
|
|
| |