Функции обработки пути оболочки
В этом разделе описаны функции обработки пути оболочки Windows. Элементы программирования, описанные в этой документации, экспортируются Shlwapi.dll и определяются в Shlwapi.h и Shlwapi.lib.
В этом разделе
| Раздел | Описание |
|---|---|
| PathAddBackslash |
Добавляет обратную косую черту в конец строки, чтобы создать правильный синтаксис для пути. Если исходный путь уже имеет конечную обратную косую черту, обратная косая черта не будет добавлена. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать более безопасную функцию PathCchAddBackslash или PathCchAddBackslashEx на своем месте. |
| PathAddExtension |
Добавляет расширение имени файла в строку пути. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать более безопасную функцию PathCchAddExtension на своем месте. |
| PathAppend |
Добавляет один путь к концу другого. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать более безопасную функцию PathCchAppend или PathCchAppendEx на своем месте. |
| PathBuildRoot |
Создает корневой путь из заданного номера диска. |
| PathCanonicalize |
Упрощает путь, удаляя элементы навигации, такие как "." и ". Для создания прямого, хорошо сформированного пути. |
| PathCombine |
Объединяет две строки, которые представляют правильные пути в один путь; также объединяет все относительные элементы пути. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать более безопасную функцию PathCchCombine или PathCchCombineEx на своем месте. |
| PathCommonPrefix |
Сравнивает два пути, чтобы определить, совместно ли они используют общий префикс. Префикс является одним из следующих типов: "C:\", ".", "..", ". \". |
| PathCompactPath |
Усечение пути к файлу в пределах заданной ширины пикселей путем замены компонентов пути многоточием. |
| PathCompactPathEx |
Усечение пути в пределах определенного количества символов путем замены компонентов пути многоточием. |
| PathCreateFromUrl |
Преобразует URL-адрес файла в путь Microsoft MS-DOS. |
| PathCreateFromUrlAlloc |
Создает путь из URL-адреса файла. |
| PathFileExists |
Определяет, является ли допустимым путь к объекту файловой системы, например файлу или папке. |
| PathFindExtension |
Выполняет поиск пути к расширению. |
| PathFindFileName |
Выполняет поиск пути к имени файла. |
| PathFindNextComponent |
Анализирует путь и возвращает часть этого пути, которая следует первой обратной косой черте. |
| PathFindOnPath |
Ищет файл. |
| PathFindSuffixArray |
Определяет, имеет ли заданное имя файла один из списков суффиксов. |
| PathGetArgs |
Находит аргументы командной строки в заданном пути. |
| PathGetCharType |
Определяет тип символа относительно пути. |
| PathGetDriveNumber |
Выполняет поиск пути к букве диска в диапазоне от "A" до "Z" и возвращает соответствующий номер диска. |
| PathIsContentType |
Определяет, соответствует ли зарегистрированный тип контента файла указанному типу контента. Эта функция получает тип контента для указанного типа файла и сравнивает эту строку с pszContentType. Сравнение выполняется без учета регистра. |
| PathIsDirectory |
Проверяет, является ли путь допустимым каталогом. |
| PathIsDirectoryEmpty |
Определяет, является ли указанный путь пустым каталогом. |
| PathIsFileSpec |
Выполняет поиск пути для любых символов с разделителями пути (например, ":" или ""). Если символы с разделителями пути отсутствуют, путь считается путь к спецификации файла. |
| PathIsHTMLFile |
Определяет, является ли файл HTML-файлом. Определение выполняется на основе типа контента, зарегистрированного для расширения файла. |
| PathIsLFNFileSpec |
Определяет, находится ли имя файла в длинном формате. |
| PathIsNetworkPath |
Определяет, представляет ли строка пути сетевой ресурс. |
| PathIsPrefix |
Выполняет поиск пути, чтобы определить, содержит ли он допустимый префикс типа, передаваемого pszPrefix. Префикс является одним из следующих типов: "C:\", ".", "..", ". \". |
| PathIsRelative |
Выполняет поиск пути и определяет, является ли он относительным. |
| PathIsRoot |
Определяет, относится ли строка пути к корню тома. |
| PathIsSameRoot |
Сравнивает два пути, чтобы определить, есть ли у них общий корневой компонент. |
| PathIsSystemFolder |
Определяет, содержит ли существующая папка атрибуты, которые делают ее системной папкой. Кроме того, эта функция указывает, соответствуют ли определенные атрибуты папке системной папке. |
| PathIsUNC |
Определяет, является ли строка пути допустимым универсальным соглашением об именовании (UNC), а не путем на основе буквы диска. |
| PathIsUNCServer |
Определяет, является ли строка допустимой UNC только для пути к серверу. |
| PathIsUNCServerShare |
Определяет, является ли строка допустимым UNC-путем, \server<em>share. |
| PathIsURL |
Проверяет указанную строку, чтобы определить, соответствует ли она допустимому формату URL-адреса. |
| PathMakePretty |
Преобразует весь верхний регистр пути ко всем строчным символам, чтобы обеспечить согласованный внешний вид пути. |
| PathMakeSystemFolder |
Предоставляет существующую папку соответствующим атрибутам, чтобы стать системной папкой. |
| PathMatchSpec |
Выполняет поиск строки с помощью типа соответствия подстановочных знаков MS-DOS. |
| PathMatchSpecEx |
Соответствует имени файла из пути к одному или нескольким шаблонам имен файлов. |
| PathParseIconLocation |
Анализирует строку расположения файла, содержащую расположение файла и индекс значка, и возвращает отдельные значения. |
| PathQuoteSpaces |
Выполняет поиск пути к пробелам. Если пробелы найдены, весь путь заключен в кавычки. |
| PathRelativePathTo |
Создает относительный путь из одного файла или папки в другой. |
| PathRemoveArgs |
Удаляет все аргументы из заданного пути. |
| PathRemoveBackslash |
Удаляет конечную обратную косую черту из заданного пути. Примечание. Эта функция устарела. Мы рекомендуем использовать функцию PathCchRemoveBackslash или PathCchRemoveBackslashEx на своем месте. |
| PathRemoveBlanks |
Удаляет все начальные и конечные пробелы из строки. |
| PathRemoveExtension |
Удаляет расширение имени файла из пути, если он присутствует. Примечание. Эта функция устарела. Мы рекомендуем использовать PathCchRemoveExtension на своем месте. |
| PathRemoveFileSpec |
Удаляет имя и обратную косую косую черту из пути, если они присутствуют. Примечание. Эта функция устарела. Мы рекомендуем использовать функцию PathCchRemoveFileSpec на своем месте. |
| PathRenameExtension |
Заменяет расширение имени файла новым расширением. Если имя файла не содержит расширения, расширение будет присоединено к концу строки. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать безопасную функцию PathCchRenameExtension на своем месте. |
| PathSearchAndQualify |
Определяет правильность форматирования и полного форматирования заданного пути. |
| PathSetDlgItemPath |
Задает текст дочернего элемента управления в окне или диалоговом окне с помощью PathCompactPath , чтобы обеспечить соответствие пути в элементе управления. |
| PathSkipRoot |
Извлекает указатель на первый символ в пути после буквы диска или элементов пути UNC-сервера или общего доступа. |
| PathStripPath |
Удаляет часть пути полного пути и файла. |
| PathStripToRoot |
Удаляет все элементы файла и каталога в пути, кроме корневой информации. Примечание. Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать безопасную функцию PathCchStripToRoot на своем месте. |
| PathUndecorate |
Удаляет украшение из строки пути. |
| PathUnExpandEnvStrings |
Заменяет определенные имена папок в полном пути связанной строкой среды. |
| PathUnmakeSystemFolder |
Удаляет атрибуты из папки, которая делает ее системной папкой. Эта папка должна существовать в файловой системе. |
| PathUnquoteSpaces |
Удаляет кавычки из начала и конца пути. |
| SHSkipJunction |
Проверяет контекст привязки, чтобы узнать, является ли оно безопасным для привязки к конкретному объекту компонента. |
| UrlApplyScheme |
Определяет схему для указанной строки URL-адреса и возвращает строку с соответствующим префиксом. |
| UrlCanonicalize |
Преобразует строку URL-адреса в каноническую форму. |
| UrlCombine |
Если указан относительный URL-адрес и его база, возвращается URL-адрес в канонической форме. |
| UrlCompare |
Выполняет сравнение двух строк URL-адресов с учетом регистра. |
| UrlCreateFromPath |
Преобразует путь MS-DOS в канонизированный URL-адрес. |
| UrlEscape |
Преобразует символы или суррогатные пары в URL-адресе, который может быть изменен во время транспорта через Интернет ("небезопасные" символы) в соответствующие escape-последовательности. Суррогатные пары — это символы между U+10000 до U+10FFFF (в UTF-32) или между DC00 до DFFF (в UTF-16). |
| UrlEscapeSpaces |
Макрос, который преобразует пробелы в соответствующую escape-последовательность. |
| UrlGetLocation |
Извлекает расположение из URL-адреса. |
| UrlGetPart |
Принимает строку URL-адреса и возвращает указанную часть этого URL-адреса. |
| UrlHash |
Хэширует строку URL-адреса. |
| URL-адреса |
Проверяет, является ли URL-адрес указанным типом. |
| UrlIsFileUrl |
Проверяет URL-адрес, чтобы определить, является ли он URL-адресом файла. |
| UrlIsNoHistory |
Возвращает, является ли URL-адрес URL-адресом, который браузеры обычно не включаются в журнал навигации. |
| UrlIsOpaque |
Возвращает значение, непрозрачное ли URL-адрес. |
| UrlUnescape |
Преобразует escape-последовательности обратно в обычные символы. |
| UrlUnescapeInPlace |
Преобразует escape-последовательности обратно в обычные символы и перезаписывает исходную строку. |