Функция PathMakePrettyW (shlwapi.h)
Преобразует путь в верхнем регистре во все символы в нижнем регистре, чтобы придать пути согласованный вид.
Синтаксис
BOOL PathMakePrettyW(
[in, out] LPWSTR pszPath
);
Параметры
[in, out] pszPath
Тип: LPTSTR
Указатель на строку длиной, заканчивающуюся значением NULL, MAX_PATH, содержащую преобразуемый путь.
Возвращаемое значение
Тип: BOOL
Возвращает значение TRUE , если путь был преобразован, или false в противном случае.
Комментарии
Эта функция работает только с путями, которые являются полностью прописными. Например: C:\WINDOWS будет преобразован в c:\windows, но c:\Windows не будет изменен.
Примеры
#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"
void main( void )
{
// Path name 1.
char buffer_1[ ] = "C:\\TEST\\FILE";
char *lpStr1;
lpStr1 = buffer_1;
// Path name 2.
char buffer_2[ ] = "c:\\test\\file";
char *lpStr2;
lpStr2 = buffer_2;
// Test path name 1.
cout << "The content of the unconverted path is : " << lpStr1 << endl;
cout << "The \"PathMakePretty\" function returns the value "
<< PathMakePretty(lpStr1) << " = TRUE & converts" << endl;
cout << "The content of the converted path is : " << lpStr1 << endl;
// Test path name 2.
cout << "\nThe content of the unconverted path is : " << lpStr2 << endl;
cout << "The \"PathMakePretty\" function returns the value "
<< PathMakePretty(lpStr2) << " = FALSE & no conversion" << endl;
cout << "The content of the converted path is : " << lpStr2 << endl;
}
OUTPUT:
=============
The content of the unconverted path is : C:\TEST\FILE
The "PathMakePretty" function returns the value 1 = TRUE & converts
The content of the converted path is : C:\test\file
The content of the unconverted path is : c:\test\file
The "PathMakePretty" function returns the value 0 = FALSE & no conversion
The content of the converted path is : c:\test\file
Примечание
Заголовок shlwapi.h определяет PathMakePretty как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | shlwapi.h |
Библиотека | Shlwapi.lib |
DLL | Shlwapi.dll (версия 4.71 или более поздняя) |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по