На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz