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 einen umgekehrten Schrägstrich am Ende einer Zeichenfolge hinzu, um die richtige Syntax für einen Pfad zu erstellen. Wenn der Quellpfad bereits über einen nachgestellten umgekehrten Schrägstrich verfügt, wird kein umgekehrter Schrägstrich hinzugefügt.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren Funktion PathCchAddBackslash oder PathCchAddBackslashEx an ihrer Stelle.

PathAddExtension
Fügt einer Pfadzeichenfolge eine Dateinamenerweiterung hinzu.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Es wird empfohlen, die sicherere PathCchAddExtension-Funktion statt zu verwenden.

PathAppend
Fügt einen Pfad an das Ende eines anderen pfads an.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Es wird empfohlen, die sicherere PathCchAppend- oder PathCchAppendEx-Funktion an seiner Stelle zu verwenden.

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 darstellen, in einem Pfad: verkettet auch alle relativen Pfadelemente.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Wir empfehlen die Verwendung der sichereren Funktion PathCchCombine oder PathCchCombineEx an ihrer Stelle.

PathCommonPrefix
Vergleicht zwei Pfade, um zu bestimmen, 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 Ausellipsen ersetzt werden.
PathCompactPathEx
Schneidet einen Pfad ab, der in eine bestimmte Anzahl von Zeichen passt, indem Pfadkomponenten durch Ellipsen 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, z. B. einer Datei oder einem Ordner, gültig ist.
PathFindExtension
Durchsucht einen Pfad nach einer Erweiterung.
PathFindFileName
Durchsucht 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 angegebener Dateiname über eine Liste von Suffixen verfügt.
PathGetArgs
Sucht die Befehlszeilenargumente innerhalb eines angegebenen Pfads.
PathGetCharType
Bestimmt den Typ des Zeichens in Bezug auf einen Pfad.
PathGetDriveNumber
Durchsucht einen Pfad nach einem Laufwerkbuchstaben im Bereich von "A" bis "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 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 eine Datei eine HTML-Datei ist. 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 bestimmen, ob er ein gültiges Präfix des von pszPrefixübergebenen Typs enthält. 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 zu bestimmen, 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 eine Pfadzeichenfolge ein gültiger Universal Naming Convention (UNC)-Pfad ist, im Gegensatz zu einem Pfad, der auf einem Laufwerkbuchstaben basiert.
PathIsUNCServer
Bestimmt, ob eine Zeichenfolge ein gültiger UNC nur für einen Serverpfad ist.
PathIsUNCServerShare
Bestimmt, ob eine Zeichenfolge ein gültiger UNC-Freigabepfad ist, \ Serverfreigabe <em> .
PathIsURL
Testet eine bestimmte Zeichenfolge, um zu ermitteln, ob sie einem gültigen URL-Format entspricht.
PathMakePretty
Konvertiert einen Pfad in Großbuchstaben in alle Kleinbuchstaben, um dem Pfad eine konsistente Darstellung zu geben.
PathMakeSystemFolder
Gibt einem vorhandenen Ordner die richtigen Attribute, um ein Systemordner zu werden.
PathMatchSpec
Durchsucht eine Zeichenfolge mithilfe eines MS-DOS-Platzhalter-Übereinstimmungstyps.
PathMatchSpecEx
Gleicht einen Dateinamen aus einem Pfad mit einem oder mehreren Dateinamensmustern ab.
PathParseIconLocation
Analysiert eine Dateispeicherortzeichenfolge, die einen Dateispeicherort und einen 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 angegebenen Pfad.
PathRemoveBackslash
Entfernt den nachgestellten umgekehrten Schrägstrich aus einem angegebenen Pfad.
[!Note]
Diese Funktion ist als veraltet markiert. Es wird empfohlen, anstelle der Funktion PathCchRemoveBackslash oder PathCchRemoveBackslashEx zu verwenden.

PathRemoveBlanks
Entfernt alle führenden und nachgestellten Leerzeichen aus einer Zeichenfolge.
PathRemoveExtension
Entfernt die Dateinamenerweiterung aus einem Pfad, sofern vorhanden.
[!Note]
Diese Funktion ist als veraltet markiert. Es wird empfohlen, anstelle von PathCchRemoveExtension zu verwenden.

PathRemoveFileSpec
Entfernt den nachgestellten Dateinamen und umgekehrten Schrägstrich aus einem Pfad, sofern vorhanden.
[!Note]
Diese Funktion ist als veraltet markiert. Es wird empfohlen, anstelle der Funktion PathCchRemoveFileSpec zu verwenden.

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.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Es wird empfohlen, die sicherere PathCchRenameExtension-Funktion an ihrer Stelle zu verwenden.

PathSearchAndQualify
Bestimmt, ob ein angegebener Pfad ordnungsgemäß formatiert und vollqualifiziert ist.
PathSetDlgItemPath
Legt den Text eines untergeordneten Steuerelements in einem Fenster oder Dialogfeld mit PathCompactPath fest, um sicherzustellen, dass der Pfad in das Steuerelement passt.
PathSkipRoot
Ruft einen Zeiger auf das erste Zeichen in einem Pfad ab, der dem Laufwerkbuchstaben oder den UNC-Server-/Freigabepfadelementen folgt.
PathStripPath
Entfernt den Pfadteil eines vollqualifizierten Pfads und einer vollqualifizierten Datei.
PathStripToRoot
Entfernt alle Datei- und Verzeichniselemente in einem Pfad mit Ausnahme der Stamminformationen.
[!Note]
Ein Missbrauch dieser Funktion kann zu einem Pufferüberlauf führen. Es wird empfohlen, die sicherere PathCchStripToRoot-Funktion an ihrer Stelle zu verwenden.

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 ihn 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 die 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 ein relative URL und seine Basis bereitgestellt werden, gibt eine URL in kanonischer Form zurück.
UrlCompare
Vergleicht zwei URL-Zeichenfolgen nach Groß-/Kleinschreibung.
UrlCreateFromPath
Konvertiert einen MS-DOS-Pfad in eine kanonische URL.
UrlEscape
Konvertiert Zeichen oder Ersatzzeichenpaare in einer URL, die während des Transports über das Internet geändert werden können ("unsichere Zeichen") in die entsprechenden Escapesequenzen. Ersatzzeichenpaare 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 aus einer URL ab.
UrlGetPart
Akzeptiert eine URL-Zeichenfolge und gibt einen angegebenen Teil dieser URL zurück.
UrlHash
Hashes einer URL-Zeichenfolge.
URLIs
Testet, ob eine URL ein angegebener Typ ist.
UrlIsFileUrl
Testet eine URL, um zu ermitteln, ob es sich um eine Datei-URL handelt.
UrlIsNoHistory
Gibt zurück, ob eine URL eine URL ist, die Browser in der Regel nicht in den Navigationsverlauf einschließen.
UrlIsOpaque
Gibt zurück, ob eine URL nicht transparent ist.
UrlUnescape
Konvertiert Escapesequenzen zurück in normale Zeichen.
UrlUnescapeInPlace
Konvertiert Escapesequenzen wieder in normale Zeichen und überschreibt die ursprüngliche Zeichenfolge.