Condividi tramite

Funzione PathCchRemoveExtension (pathcch.h)

  • Articolo

Rimuove l'estensione del nome file da un percorso, se presente.

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

NotaQuesta funzione deve essere usata al posto di PathRemoveExtension per impedire l'overrun di un buffer.

Sintassi

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parametri

[in, out] pszPath

Puntatore alla stringa del percorso. Quando questa funzione restituisce correttamente, la stringa contiene il percorso con qualsiasi estensione rimossa. Se non è stata trovata alcuna estensione, la stringa è invariata.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

Valore restituito

Questa funzione restituisce S_OK se la funzione ha esito positivo, S_FALSE se non è stata trovata alcuna estensione o un codice di errore in caso contrario.

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