Funzione PathCommonPrefixW (shlwapi.h)

Articolo
11/20/2024

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 di lunghezza con terminazione Null MAX_PATH che contiene il nome del primo percorso.

[in] pszFile2

Tipo: LPCTSTR

Puntatore a una stringa di lunghezza con terminazione Null MAX_PATH che contiene il secondo nome del percorso.

[out, optional] achPath

Tipo: LPTSTR

Puntatore a un buffer che riceve il prefisso comune. Questo buffer deve avere dimensioni di almeno MAX_PATH caratteri. Se non è presente alcun prefisso comune, viene 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.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite