Funzione PathAllocCombine (pathcch.h)
Concatena due frammenti di percorso in un singolo percorso. Questa funzione esegue anche la canonizzazione di tutti gli elementi di percorso relativi, sostituendo gli elementi del percorso, ad esempio "." e "..".
Questa funzione è diversa da PathCchCombine e PathCchCombineEx in quanto restituisce il risultato nell'heap. Ciò significa che il chiamante non deve dichiarare le dimensioni della stringa restituita e riduce l'uso dello stack.
Questa funzione è diversa da PathCombine in quanto accetta percorsi con prefissi "\", "\?" e "\?\UNC".
Sintassi
WINPATHCCHAPI HRESULT PathAllocCombine(
[in] PCWSTR pszPathIn,
[in] PCWSTR pszMore,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
Parametri
[in] pszPathIn
Puntatore alla prima stringa di percorso.
[in] pszMore
Puntatore alla seconda stringa di percorso. Se questo percorso inizia con una singola barra rovesciata, viene combinato con solo la radice del percorso a cui punta pszPathIn. Se questo percorso è completo, viene copiato direttamente nel buffer di output senza essere combinato con l'altro percorso.
[in] dwFlags
Uno o più dei flag seguenti:
[out] ppszPathOut
L'indirizzo di un puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve la stringa di percorso combinata. È responsabilità del chiamante liberare questa risorsa, quando non è più necessaria, chiamando la funzione LocalFree . Questo valore non può essere NULL.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Anche se pszPathIn o pszMore può essere NULL, non può essere NULL.
Questa funzione supporta questi moduli di percorso alternativo:
- \\?\
- \\?\\UNC\
- \\?\Volume{guid}\
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per