PathCommonPrefixW-Funktion (shlwapi.h)

Artikel
11/20/2024

Vergleicht zwei Pfade, um festzustellen, ob sie ein gemeinsames Präfix verwenden. Ein Präfix ist einer der folgenden Typen: "C:\", ".", "..", ".". \".

Syntax

int PathCommonPrefixW(
  [in]            LPCWSTR pszFile1,
  [in]            LPCWSTR pszFile2,
  [out, optional] LPWSTR  achPath
);

Parameter

[in] pszFile1

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge MAX_PATH, die den ersten Pfadnamen enthält.

[in] pszFile2

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge MAX_PATH, die den zweiten Pfadnamen enthält.

[out, optional] achPath

Typ: LPTSTR-

Ein Zeiger auf einen Puffer, der das allgemeine Präfix empfängt. Dieser Puffer muss mindestens MAX_PATH Zeichen groß sein. Wenn kein allgemeines Präfix vorhanden ist, wird es auf NULL-festgelegt.

Rückgabewert

Typ: int

Gibt die Anzahl der allgemeinen Präfixzeichen im Pfad zurück. Wenn der Ausgabepufferzeiger nicht NULL-ist, werden diese Zeichen in den Ausgabepuffer kopiert.

Bemerkungen

Anmerkung

Der Header "shlwapi.h" definiert PathCommonPrefix als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über