Funzione PathCchFindExtension (pathcch.h)

  • Articolo

Cerca un percorso per trovare l'estensione del nome file, ad esempio ".exe" o ".ini". Questa funzione non cerca un'estensione specifica; cerca la presenza di qualsiasi estensione.

Questa funzione differisce dai prefissi PathFindExtension in cui accetta i percorsi con "\", "\?" e "\?\UNC".

Nota Questa funzione deve essere usata al posto di PathFindExtension per evitare la possibilità di un overrun del buffer.

Sintassi

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Parametri

[in] pszPath

Puntatore al percorso di ricerca.

[in] cchPath

Dimensioni del buffer a cui fa riferimento pszPath in caratteri, incluso il terminatore Null.

[out] ppszExt

L'indirizzo di un puntatore che, quando questa funzione restituisce correttamente, punta al carattere "." che precede l'estensione all'interno di pszPath. Se non viene trovata alcuna estensione, punta al carattere null di terminazione della stringa.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione pathcch.h
Libreria Pathcch.lib