Funzione PathCchRemoveBackslashEx (pathcch.h)

Articolo
03/05/2024

Rimuove la barra rovesciata finale dalla fine di una stringa di percorso.

Questa funzione differisce da PathCchRemoveBackslash in quanto può restituire un puntatore alla nuova fine della stringa e segnalare il numero di caratteri inutilizzati rimanenti nel buffer.

Questa funzione differisce da PathRemoveBackslash in quanto accetta percorsi con prefissi "\", "\?" e "\?\UNC".

Nota Questa funzione, o PathCchRemoveBackslash, deve essere usata al posto di PathRemoveBackslash per evitare la possibilità di un sovraccarico del buffer.

Sintassi

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

Parametri

[in, out] pszPath

Puntatore alla stringa di percorso. Quando questa funzione viene restituita correttamente, la stringa contiene il percorso con qualsiasi barra rovesciata finale rimossa. Se non è stata trovata alcuna barra rovesciata finale, la stringa rimane invariata.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

[out, optional] ppszEnd

Valore che, quando questa funzione viene restituita correttamente, riceve l'indirizzo di un puntatore alla fine della nuova stringa. Se la stringa è un percorso radice, ad esempio "C:", il puntatore punta alla barra rovesciata; in caso contrario, il puntatore punta al carattere Null di terminazione della stringa.

[out, optional] pcchRemaining

Puntatore a un valore che, quando questa funzione viene restituita correttamente, riceve il numero di caratteri inutilizzati nel buffer di destinazione, incluso il carattere Null di terminazione. Se la stringa è un percorso radice, ad esempio "C:", questo conteggio include la barra rovesciata in tale stringa.

Valore restituito

Questa funzione restituisce S_OK se la funzione ha avuto esito positivo, S_FALSE se la stringa è un percorso radice o se non è stata trovata alcuna barra rovesciata o un codice di errore in caso contrario.

Commenti

Questa funzione non rimuoverà la barra rovesciata da una stringa di percorso radice, ad esempio "C:".

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

Condividi tramite