Shellpfadbehandlungsfunktionen
In diesem Abschnitt werden die Windows Shell-Pfadbehandlungsfunktionen beschrieben. Die in dieser Dokumentation erläuterten Programmierelemente werden von Shlwapi.dll exportiert und in Shlwapi.h und Shlwapi.lib definiert.
In diesem Abschnitt
Thema | Beschreibung |
---|---|
PathAddBackslash |
Fügt am Ende einer Zeichenfolge einen umgekehrten Schrägstrich hinzu, um die richtige Syntax für einen Pfad zu erstellen. Wenn der Quellpfad bereits einen nachgestellten umgekehrten Schrägstrich aufweist, wird kein umgekehrter Schrägstrich hinzugefügt. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchAddBackslash - oder PathCchAddBackslashEx-Funktion an seiner Stelle. |
PathAddExtension |
Fügt eine Dateinamenerweiterung zu einer Pfadzeichenfolge hinzu. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchAddExtension-Funktion an seiner Stelle. |
PathAppend |
Fügt einen Pfad an das Ende einer anderen an. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchAppend - oder PathCchAppendEx-Funktion an seiner Stelle. |
PathBuildRoot |
Erstellt einen Stammpfad aus einer angegebenen Laufwerksnummer. |
PathCanonicalize |
Vereinfacht einen Pfad, indem Navigationselemente wie "." und "." entfernt werden, um einen direkten, wohlgeformten Pfad zu erzeugen. |
PathCombine |
Verkettet zwei Zeichenfolgen, die ordnungsgemäß gebildete Pfade in einem Pfad darstellen; verkettet auch alle relativen Pfadelemente. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchCombine - oder PathCchCombineEx-Funktion an seiner Stelle. |
PathCommonPrefix |
Vergleicht zwei Pfade, um festzustellen, ob sie ein gemeinsames Präfix verwenden. Ein Präfix ist einer der folgenden Typen: "C:\", ".", "..", ".". \". |
PathCompactPath |
Schneidet einen Dateipfad ab, der in eine bestimmte Pixelbreite passt, indem Pfadkomponenten durch Auslassungspunkte ersetzt werden. |
PathCompactPathEx |
Schneidet einen Pfad ab, der in eine bestimmte Anzahl von Zeichen passt, indem Pfadkomponenten durch Auslassungspunkte ersetzt werden. |
PathCreateFromUrl |
Konvertiert eine Datei-URL in einen Microsoft MS-DOS-Pfad. |
PathCreateFromUrlAlloc |
Erstellt einen Pfad aus einer Datei-URL. |
PathFileExists |
Bestimmt, ob ein Pfad zu einem Dateisystemobjekt wie einer Datei oder einem Ordner gültig ist. |
PathFindExtension |
Durchsucht einen Pfad für eine Erweiterung. |
PathFindFileName |
Sucht einen Pfad nach einem Dateinamen. |
PathFindNextComponent |
Analysiert einen Pfad und gibt den Teil dieses Pfads zurück, der dem ersten umgekehrten Schrägstrich folgt. |
PathFindOnPath |
Sucht nach einer Datei. |
PathFindSuffixArray |
Bestimmt, ob ein bestimmter Dateiname über eine Liste von Suffixen verfügt. |
PathGetArgs |
Sucht die Befehlszeilenargumente innerhalb eines bestimmten Pfads. |
PathGetCharType |
Bestimmt den Zeichentyp in Bezug auf einen Pfad. |
PathGetDriveNumber |
Durchsucht einen Pfad nach einem Laufwerkbuchstaben im Bereich von "A" zu "Z" und gibt die entsprechende Laufwerksnummer zurück. |
PathIsContentType |
Bestimmt, ob der registrierte Inhaltstyp einer Datei mit dem angegebenen Inhaltstyp übereinstimmt. Diese Funktion ruft den Inhaltstyp für den angegebenen Dateityp ab und vergleicht diese Zeichenfolge mit dem pszContentType. Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt. |
PathIsDirectory |
Überprüft, ob ein Pfad ein gültiges Verzeichnis ist. |
PathIsDirectoryEmpty |
Bestimmt, ob ein angegebener Pfad ein leeres Verzeichnis ist. |
PathIsFileSpec |
Durchsucht einen Pfad nach pfadtrennenden Zeichen (z. B. ":" oder "" ). Wenn keine Pfadtrennzeichen vorhanden sind, wird der Pfad als Dateispezifikationspfad betrachtet. |
PathIsHTMLFile |
Bestimmt, ob es sich bei einer Datei um eine HTML-Datei handelt. Die Ermittlung erfolgt basierend auf dem Inhaltstyp, der für die Erweiterung der Datei registriert ist. |
PathIsLFNFileSpec |
Bestimmt, ob ein Dateiname im langen Format vorliegt. |
PathIsNetworkPath |
Bestimmt, ob eine Pfadzeichenfolge eine Netzwerkressource darstellt. |
PathIsPrefix |
Durchsucht einen Pfad, um zu ermitteln, ob es ein gültiges Präfix des Typs enthält, der von pszPrefix übergeben wird. Ein Präfix ist einer der folgenden Typen: "C:\", ".", "..", ".". \". |
PathIsRelative |
Durchsucht einen Pfad und bestimmt, ob er relativ ist. |
PathIsRoot |
Bestimmt, ob eine Pfadzeichenfolge auf den Stamm eines Volumes verweist. |
PathIsSameRoot |
Vergleicht zwei Pfade, um festzustellen, ob sie über eine gemeinsame Stammkomponente verfügen. |
PathIsSystemFolder |
Bestimmt, ob ein vorhandener Ordner die Attribute enthält, die ihn zu einem Systemordner machen. Alternativ gibt diese Funktion an, ob bestimmte Attribute einen Ordner als Systemordner qualifizieren. |
PathIsUNC |
Bestimmt, ob es sich bei einer Pfadzeichenfolge um einen gültigen UNC-Pfad (Universal Naming Convention) im Gegensatz zu einem Pfad handelt, der auf einem Laufwerkbuchstaben basiert. |
PathIsUNCServer |
Bestimmt, ob es sich bei einer Zeichenfolge nur um einen gültigen UNC für einen Serverpfad handelt. |
PathIsUNCServerShare |
Bestimmt, ob eine Zeichenfolge ein gültiger UNC-Freigabepfad, \server<em-Freigabe>, ist. |
PathIsURL |
Testet eine bestimmte Zeichenfolge, um festzustellen, ob sie einem gültigen URL-Format entspricht. |
PathMakePretty |
Konvertiert einen vollständigen Pfad in Großbuchstaben in alle Kleinbuchstaben, um dem Pfad ein einheitliches Erscheinungsbild zu verleihen. |
PathMakeSystemFolder |
Gibt einem vorhandenen Ordner die richtigen Attribute, um zu einem Systemordner zu werden. |
PathMatchSpec |
Durchsucht eine Zeichenfolge mit einem MS-DOS-Wildcard-Übereinstimmungstyp. |
PathMatchSpecEx |
Entspricht einem Dateinamen aus einem Pfad mit einem oder mehreren Dateinamenmustern. |
PathParseIconLocation |
Analysiert eine Dateispeicherortzeichenfolge, die einen Dateispeicherort und Symbolindex enthält, und gibt separate Werte zurück. |
PathQuoteSpaces |
Durchsucht einen Pfad nach Leerzeichen. Wenn Leerzeichen gefunden werden, wird der gesamte Pfad in Anführungszeichen eingeschlossen. |
PathRelativePathTo |
Erstellt einen relativen Pfad von einer Datei oder einem Ordner zu einer anderen. |
PathRemoveArgs |
Entfernt alle Argumente aus einem bestimmten Pfad. |
PathRemoveBackslash |
Entfernt den nachfolgenden umgekehrten Schrägstrich aus einem bestimmten Pfad. Hinweis: Diese Funktion ist veraltet. Wir empfehlen die Verwendung der PathCchRemoveBackslash- oder PathCchRemoveBackslashEx-Funktion an seiner Stelle. |
PathRemoveBlanks |
Entfernt alle führenden und nachfolgenden Leerzeichen aus einer Zeichenfolge. |
PathRemoveExtension |
Entfernt die Dateinamenerweiterung aus einem Pfad, falls vorhanden. Hinweis: Diese Funktion ist veraltet. Wir empfehlen die Verwendung des PathCchRemoveExtension an seinem Ort. |
PathRemoveFileSpec |
Entfernt den nachgestellten Dateinamen und umgekehrten Schrägstrich aus einem Pfad, falls vorhanden. Hinweis: Diese Funktion ist veraltet. Wir empfehlen die Verwendung der PathCchRemoveFileSpec-Funktion an seiner Stelle. |
PathRenameExtension |
Ersetzt die Erweiterung eines Dateinamens durch eine neue Erweiterung. Wenn der Dateiname keine Erweiterung enthält, wird die Erweiterung am Ende der Zeichenfolge angefügt. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchRenameExtension-Funktion an seiner Stelle. |
PathSearchAndQualify |
Bestimmt, ob ein bestimmter Pfad korrekt formatiert und vollqualifizierter Pfad ist. |
PathSetDlgItemPath |
Legt den Text eines untergeordneten Steuerelements in einem Fenster oder Dialogfeld mithilfe von PathCompactPath fest, um sicherzustellen, dass der Pfad in das Steuerelement passt. |
PathSkipRoot |
Ruft einen Zeiger auf das erste Zeichen in einem Pfad nach dem Laufwerkbuchstaben oder UNC-Server-/Freigabepfadelementen ab. |
PathStripPath |
Entfernt den Pfadteil eines vollqualifizierten Pfads und einer vollqualifizierten Datei. |
PathStripToRoot |
Entfernt alle Datei- und Verzeichniselemente in einem Pfad mit Ausnahme der Stamminformationen. Hinweis: Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren PathCchStripToRoot-Funktion an seiner Stelle. |
PathUndecorate |
Entfernt die Dekoration aus einer Pfadzeichenfolge. |
PathUnExpandEnvStrings |
Ersetzt bestimmte Ordnernamen in einem vollqualifizierten Pfad durch die zugehörige Umgebungszeichenfolge. |
PathUnmakeSystemFolder |
Entfernt die Attribute aus einem Ordner, der es zu einem Systemordner macht. Dieser Ordner muss tatsächlich im Dateisystem vorhanden sein. |
PathUnquoteSpaces |
Entfernt Anführungszeichen vom Anfang und Ende eines Pfads. |
SHSkipJunction |
Überprüft einen Bindungskontext, um festzustellen, ob eine Bindung an ein bestimmtes Komponentenobjekt sicher ist. |
UrlApplyScheme |
Bestimmt ein Schema für eine angegebene URL-Zeichenfolge und gibt eine Zeichenfolge mit einem entsprechenden Präfix zurück. |
UrlCanonicalize |
Konvertiert eine URL-Zeichenfolge in ein kanonisches Format. |
UrlCombine |
Wenn eine relative URL und ihre Basis bereitgestellt werden, wird eine URL in kanonischer Form zurückgegeben. |
UrlCompare |
Führt einen Vergleich zwischen zwei URL-Zeichenfolgen durch, bei dem die Groß-/Kleinschreibung beachtet wird. |
UrlCreateFromPath |
Konvertiert einen MS-DOS-Pfad in eine kanonisierte URL. |
UrlEscape |
Wandelt Zeichen oder Ersatzpaare in einer URL um, die während des Transports im Internet ("unsichere" Zeichen) in die entsprechenden Escapesequenzen geändert werden können. Ersatzpaare sind Zeichen zwischen U+10000 und U+10FFFF (in UTF-32) oder zwischen DC00 und DFFF (in UTF-16). |
UrlEscapeSpaces |
Ein Makro, das Leerzeichen in die entsprechende Escapesequenz konvertiert. |
UrlGetLocation |
Ruft den Speicherort von einer URL ab. |
UrlGetPart |
Akzeptiert eine URL-Zeichenfolge und gibt einen angegebenen Teil dieser URL zurück. |
UrlHash |
Hasht eine URL-Zeichenfolge. |
URLIs |
Überprüft, ob eine URL ein angegebener Typ ist. |
UrlIsFileUrl |
Testet eine URL, um festzustellen, ob es sich um eine Datei-URL handelt. |
UrlIsNoHistory |
Gibt zurück, ob es sich bei einer URL um eine URL handelt, die Browser in der Regel nicht in den Navigationsverlauf einschließen. |
UrlIsOpaque |
Gibt zurück, ob eine URL undurchsichtig ist. |
UrlUnescape |
Konvertiert Escapesequenzen wieder in normale Zeichen. |
UrlUnescapeInPlace |
Konvertiert Escapesequenzen wieder in normale Zeichen und überschreibt die ursprüngliche Zeichenfolge. |