PathCommonPrefixW-Funktion (shlwapi.h)

  • Artikel

Vergleicht zwei Pfade, um zu ermitteln, ob sie ein gemeinsames Präfix haben. 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 der Länge MAX_PATH, die den ersten Pfadnamen enthält.

[in] pszFile2

Typ: LPCTSTR

Ein Zeiger auf eine mit NULL beendete Zeichenfolge der Länge 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 allgemeiner Präfixzeichen im Pfad zurück. Wenn der Ausgabepufferzeiger nicht NULL ist, werden diese Zeichen in den Ausgabepuffer kopiert.

Hinweise

Hinweis

Der shlwapi.h-Header 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 4.71 oder höher)