Funzione PathCchAddBackslashEx (pathcch.h)

Articolo
03/05/2024

Aggiunge una barra rovesciata alla fine di una stringa per creare la sintassi corretta per un percorso. Se il percorso di origine ha già una barra rovesciata finale, non verrà aggiunta alcuna barra rovesciata.

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

Questa funzione è diversa da PathAddBackslash in cui accetta i percorsi con "\", "\?" e "\?\UNC".

Nota Questa funzione o PathCchAddBackslash deve essere usata al posto di PathAddBackslash per impedire la possibilità di un overrun del buffer.

Sintassi

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

Parametri

[in, out] pszPath

Puntatore alla stringa del percorso. Quando questa funzione restituisce correttamente, il buffer contiene la stringa con la barra rovesciata aggiunta. Questo valore non deve essere NULL.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

[out, optional] ppszEnd

Valore che, quando questa funzione restituisce correttamente, riceve l'indirizzo di un puntatore al carattere Null terminante alla fine della stringa.

[out, optional] pcchRemaining

Puntatore a un valore che, quando questa funzione restituisce correttamente, è impostata sul numero di caratteri inutilizzati nel buffer di destinazione, incluso il carattere Null di terminazione.

Valore restituito

Questa funzione restituisce S_OK se la funzione ha esito positivo, S_FALSE se la stringa di percorso termina già in una barra rovesciata 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

Vedi anche

PathCchAddBackslash

Condividi tramite