Funzione PathCchRemoveBackslashEx (pathcch.h)

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".

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