Funkcje obsługi ścieżek powłoki
W tej sekcji opisano funkcje obsługi ścieżek powłoki systemu Windows. Elementy programowania wyjaśnione w tej dokumentacji są eksportowane przez Shlwapi.dll i zdefiniowane w plikach Shlwapi.h i Shlwapi.lib.
W tej sekcji
| Temat | Opis |
|---|---|
|
PathAddBackslash |
Dodaje ukośnik odwrotny na końcu ciągu, aby utworzyć poprawną składnię dla ścieżki. Jeśli ścieżka źródłowa ma już ukośnik odwrotny, nie zostanie dodany ukośnik odwrotny. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej funkcji PathCchAddBackslash lub PathCchAddBackslashEx miejscu. |
|
PathAddExtension |
Dodaje rozszerzenie nazwy pliku do ciągu ścieżki. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej funkcji PathCchAddExtension. |
|
PathAppend |
Dołącza jedną ścieżkę na końcu innego. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej PathCchAppend lub PathCchAppendEx funkcji. |
|
PathBuildRoot |
Tworzy ścieżkę główną na podstawie danego numeru dysku. |
|
PathCanonicalize |
Upraszcza ścieżkę, usuwając elementy nawigacji, takie jak "." i ".". w celu utworzenia bezpośredniej, dobrze sformułowanej ścieżki. |
|
PathCombine |
Łączy dwa ciągi reprezentujące prawidłowo sformułowane ścieżki w jedną ścieżkę; łączy również wszystkie elementy ścieżki względnej. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej PathCchCombine lub PathCchCombineEx funkcji. |
|
pathCommonPrefix |
Porównuje dwie ścieżki, aby określić, czy mają wspólny prefiks. Prefiks jest jednym z następujących typów: "C:\", ".", ".".". \". |
|
PathCompactPath |
Obcina ścieżkę pliku, która mieści się w obrębie danej szerokości pikseli, zastępując składniki ścieżki wielokropkiem. |
|
PathCompactPathEx |
Obcina ścieżkę do dopasowania do określonej liczby znaków, zastępując składniki ścieżki wielokropkiem. |
|
PathCreateFromUrl |
Konwertuje adres URL pliku na ścieżkę MS-DOS firmy Microsoft. |
|
PathCreateFromUrlAlloc |
Tworzy ścieżkę na podstawie adresu URL pliku. |
|
PathFileExists |
Określa, czy ścieżka do obiektu systemu plików, takiego jak plik lub folder, jest prawidłowa. |
|
PathFindExtension |
Wyszukuje ścieżkę rozszerzenia. |
|
PathFindFileName |
Wyszukuje ścieżkę dla nazwy pliku. |
|
PathFindNextComponent |
Analizuje ścieżkę i zwraca część tej ścieżki, która następuje po pierwszym ukośniku odwrotnym. |
|
PathFindOnPath |
Wyszukuje plik. |
|
PathFindSuffixArray |
Określa, czy dana nazwa pliku ma jedną z list sufiksów. |
|
PathGetArgs |
Znajduje argumenty wiersza polecenia w ramach danej ścieżki. |
|
PathGetCharType |
Określa typ znaku w odniesieniu do ścieżki. |
|
PathGetDriveNumber |
Wyszukuje ścieżkę dla litery dysku w zakresie od "A" do "Z" i zwraca odpowiedni numer dysku. |
|
PathIsContentType |
Określa, czy zarejestrowany typ zawartości pliku jest zgodny z określonym typem zawartości. Ta funkcja uzyskuje typ zawartości dla określonego typu pliku i porównuje ten ciąg z pszContentType. Porównanie nie uwzględnia wielkości liter. |
|
PathIsDirectory |
Sprawdza, czy ścieżka jest prawidłowym katalogiem. |
|
PathIsDirectoryEmpty |
Określa, czy określona ścieżka jest pustym katalogiem. |
|
PathIsFileSpec |
Wyszukuje ścieżkę dla dowolnych znaków ograniczników ścieżki (na przykład ":" lub ""). Jeśli nie ma żadnych znaków ogranicznika ścieżki, ścieżka jest uważana za ścieżkę specyfikacji pliku. |
|
PathIsHTMLFile |
Określa, czy plik jest plikiem HTML. Określenie jest wykonywane na podstawie typu zawartości zarejestrowanego dla rozszerzenia pliku. |
|
PathIsLFNFileSpec |
Określa, czy nazwa pliku ma długi format. |
|
PathIsNetworkPath |
Określa, czy ciąg ścieżki reprezentuje zasób sieciowy. |
|
PathIsPrefix |
Wyszukuje ścieżkę, aby określić, czy zawiera prawidłowy prefiks typu przekazanego przez pszPrefix. Prefiks jest jednym z następujących typów: "C:\", ".", ".".". \". |
|
PathIsRelative |
Wyszukuje ścieżkę i określa, czy jest względna. |
|
PathIsRoot |
Określa, czy ciąg ścieżki odwołuje się do katalogu głównego woluminu. |
|
PathIsSameRoot |
Porównuje dwie ścieżki, aby określić, czy mają wspólny składnik główny. |
|
PathIsSystemFolder |
Określa, czy istniejący folder zawiera atrybuty, które sprawiają, że jest to folder systemowy. Alternatywnie ta funkcja wskazuje, czy niektóre atrybuty kwalifikują folder do folderu systemowego. |
|
PathIsUNC |
Określa, czy ciąg ścieżki jest prawidłową ścieżką Universal Naming Convention (UNC), w przeciwieństwie do ścieżki na podstawie litery dysku. |
|
PathIsUNCServer |
Określa, czy ciąg jest prawidłowym kluczem UNC tylko dla ścieżki serwera. |
|
PathIsUNCServerShare |
Określa, czy ciąg jest prawidłową ścieżką udziału UNC, \serwera<>udziału. |
|
pathIsURL |
Testuje dany ciąg, aby określić, czy jest zgodny z prawidłowym formatem adresu URL. |
|
PathMakePretty |
Konwertuje ścieżkę z wielką literą na wszystkie małe litery, aby nadać ścieżce spójny wygląd. |
|
PathMakeSystemFolder |
Nadaje istniejącemu folderowi odpowiednie atrybuty, aby stać się folderem systemowym. |
|
PathMatchSpec |
Wyszukuje ciąg przy użyciu typu dopasowania symbolu wieloznakowego MS-DOS. |
|
PathMatchSpecEx |
Dopasuje nazwę pliku ze ścieżki do co najmniej jednego wzorca nazwy pliku. |
|
PathParseIconLocation |
Analizuje ciąg lokalizacji pliku zawierający lokalizację pliku i indeks ikony oraz zwraca oddzielne wartości. |
|
PathQuoteSpaces |
Wyszukuje ścieżkę dla spacji. W przypadku znalezienia spacji cała ścieżka jest ujęta w znaki cudzysłowu. |
|
PathRelativePathTo |
Tworzy ścieżkę względną z jednego pliku lub folderu do innego. |
|
PathRemoveArgs |
Usuwa wszystkie argumenty z danej ścieżki. |
|
PathRemoveBackslash |
Usuwa końcowy ukośnik odwrotny z danej ścieżki. Uwaga: Ta funkcja jest przestarzała. Zalecamy użycie funkcji PathCchRemoveBackslash lub PathCchRemoveBackslashEx miejscu. |
|
PathRemoveBlanks |
Usuwa wszystkie spacje wiodące i końcowe z ciągu. |
|
PathRemoveExtension |
Usuwa rozszerzenie nazwy pliku ze ścieżki, jeśli istnieje. Uwaga: Ta funkcja jest przestarzała. Zalecamy użyciePathCchRemoveExtension. |
|
PathRemoveFileSpec |
Usuwa końcową nazwę pliku i ukośnik odwrotny ze ścieżki, jeśli są obecne. Uwaga: Ta funkcja jest przestarzała. Zalecamy użycie funkcji PathCchRemoveFileSpec w swoim miejscu. |
|
PathRenameExtension |
Zastępuje rozszerzenie nazwy pliku nowym rozszerzeniem. Jeśli nazwa pliku nie zawiera rozszerzenia, rozszerzenie zostanie dołączone na końcu ciągu. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej funkcji PathCchRenameExtension. |
|
PathSearchAndQualify |
Określa, czy dana ścieżka jest poprawnie sformatowana i w pełni kwalifikowana. |
|
PathSetDlgItemPath |
Ustawia tekst kontrolki podrzędnej w oknie lub oknie dialogowym przy użyciu PathCompactPath, aby upewnić się, że ścieżka pasuje do kontrolki. |
|
PathSkipRoot |
Pobiera wskaźnik do pierwszego znaku w ścieżce po literze dysku lub elementach serwera UNC/ścieżki udziału. |
|
PathStripPath |
Usuwa część ścieżki w pełni kwalifikowanej ścieżki i pliku. |
|
PathStripToRoot |
Usuwa wszystkie elementy pliku i katalogu w ścieżce z wyjątkiem informacji głównych. Uwaga: Nieprawidłowe użycie tej funkcji może prowadzić do przepełnienia buforu. Zalecamy użycie bezpieczniejszej funkcji PathCchStripToRoot. |
|
pathUndecorate |
Usuwa dekorację z ciągu ścieżki. |
|
PathUnExpandEnvStrings |
Zastępuje niektóre nazwy folderów w w pełni kwalifikowanej ścieżki skojarzonym z nimi ciągiem środowiska. |
|
PathUnmakeSystemFolder |
Usuwa atrybuty z folderu, który czyni go folderem systemowym. Ten folder musi rzeczywiście istnieć w systemie plików. |
|
PathUnquoteSpaces |
Usuwa cudzysłowy od początku i końca ścieżki. |
|
shSkipJunction |
Sprawdza kontekst powiązania, aby sprawdzić, czy powiązanie z określonym obiektem składnika jest bezpieczne. |
|
UrlApplyScheme |
Określa schemat dla określonego ciągu adresu URL i zwraca ciąg z odpowiednim prefiksem. |
|
UrlCanonicalize |
Konwertuje ciąg adresu URL na postać kanoniczną. |
|
UrlKombine |
Po podaniu względnego adresu URL i jego podstawy zwraca adres URL w postaci kanonicznej. |
|
UrlCompare |
Tworzy porównanie z uwzględnieniem wielkości liter dwóch ciągów adresu URL. |
| adres URL UtwórzFromPath |
Konwertuje ścieżkę MS-DOS na kanoniczny adres URL. |
|
UrlEscape |
Konwertuje znaki lub pary zastępcze w adresie URL, które mogą zostać zmienione podczas transportu przez Internet ("niebezpieczne" znaki) do odpowiednich sekwencji ucieczki. Pary zastępcze to znaki z zakresu od U+10000 do U+10FFFF (w formacie UTF-32) lub od DC00 do DFFF (w formacie UTF-16). |
|
UrlEscapeSpaces |
Makro, które konwertuje znaki spacji na odpowiadającą im sekwencję ucieczki. |
|
UrlGetLocation |
Pobiera lokalizację z adresu URL. |
|
UrlGetPart |
Akceptuje ciąg adresu URL i zwraca określoną część tego adresu URL. |
|
UrlHash |
Skróty ciągu adresu URL. |
|
adresy URLI |
Sprawdza, czy adres URL jest określonym typem. |
|
UrlIsFileUrl |
Testuje adres URL, aby określić, czy jest to adres URL pliku. |
|
UrlIsNoHistory |
Zwraca, czy adres URL jest adresem URL, który przeglądarki zwykle nie zawierają w historii nawigacji. |
|
UrlIsOpaque |
Zwraca, czy adres URL jest nieprzezroczystym. |
|
UrlUnescape |
Konwertuje sekwencje ucieczki z powrotem na zwykłe znaki. |
|
UrlUnescapeInPlace |
Konwertuje sekwencje ucieczki z powrotem na zwykłe znaki i zastępuje oryginalny ciąg. |