Funzione PathCommonPrefixW (shlwapi.h)

Articolo
03/15/2023

Confronta due percorsi per determinare se condividono un prefisso comune. Un prefisso è uno di questi tipi: "C:\", ".", "..", ".. \".

Sintassi

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

Parametri

[in] pszFile1

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null di lunghezza MAX_PATH contenente il nome del primo percorso.

[in] pszFile2

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null di lunghezza MAX_PATH contenente il secondo nome del percorso.

[out, optional] achPath

Tipo: LPTSTR

Puntatore a un buffer che riceve il prefisso comune. Questo buffer deve essere almeno MAX_PATH caratteri in dimensione. Se non esiste un prefisso comune, è impostato su NULL.

Valore restituito

Tipo: int

Restituisce il numero di caratteri di prefisso comuni nel percorso. Se il puntatore del buffer di output non è NULL, questi caratteri vengono copiati nel buffer di output.

Commenti

Nota

L'intestazione shlwapi.h definisce PathCommonPrefix come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite