Funzione PathCchAppend (pathcch.h)

Articolo
03/01/2024

Aggiunge un percorso alla fine di un altro.

Questa funzione differisce da PathCchAppendEx in quanto è limitato a un percorso finale di lunghezza MAX_PATH.

Questa funzione è diversa da PathAppend in quanto accetta percorsi con prefissi "\", "\?" e "\?\UNC".

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

Sintassi

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Parametri

[in, out] pszPath

Puntatore a un buffer che, all'ingresso, contiene il percorso originale. Quando questa funzione viene restituita correttamente, il buffer contiene il percorso originale più il percorso aggiunto.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

[in, optional] pszMore

Puntatore al percorso da aggiungere alla fine del percorso a cui punta pszPath. I percorsi e i percorsi UNC che iniziano con la sequenza "\?" vengono accettati e riconosciuti come percorsi completi. Questi percorsi sostituiscono la stringa a cui punta pszPath anziché essere accodati.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice HRESULT , incluso quanto segue.

Codice restituito	Descrizione
E_INVALIDARG	PszPath o pszMore è NULL, cchPath è 0 o cchPath è maggiore di PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG	La stringa risultante supererebbe PATHCCH_MAX_CCH.
E_OUTOFMEMORY	La funzione non è riuscita ad allocare un buffer delle dimensioni necessarie.

Commenti

Questa funzione inserisce una barra rovesciata tra le due stringhe, se non ne è già presente una.

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

PathCchAppendEx

Condividi tramite