Funzione PathAppendA (shlwapi.h)

Articolo
03/02/2024

Aggiunge un percorso alla fine di un altro.

Nota L'uso improprio di questa funzione può causare un sovraccarico del buffer. È consigliabile usare la funzione PathCchAppend o PathCchAppendEx più sicura al suo posto.

Sintassi

BOOL PathAppendA(
  [in, out] LPSTR  pszPath,
  [in]      LPCSTR pszMore
);

Parametri

[in, out] pszPath

Tipo: LPTSTR

Puntatore a una stringa con terminazione Null a cui viene aggiunto il percorso specificato in pszMore . È necessario impostare le dimensioni di questo buffer su MAX_PATH per assicurarsi che sia sufficientemente grande da contenere la stringa restituita.

[in] pszMore

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH contenente il percorso da accodare.

Valore restituito

Tipo: BOOL

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario.

Commenti

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

Il percorso fornito in pszPath non può iniziare con ".. \" o ".\" per produrre una stringa di percorso relativa. Se presente, questi punti vengono rimossi dalla stringa di output. Ad esempio, aggiungendo "path3" a ".. \path1\path2" restituisce un output "\path1\path2\path3" anziché ".. \path1\path2\path3".

Esempi


#include <windows.h>
#include <iostream>
#include "Shlwapi.h"

using namespace std;

int main( void )
{
	// String for path name.
	char buffer_1[MAX_PATH] = "name_1\\name_2";
	char *lpStr1;
	lpStr1 = buffer_1;

	// String of what is being added.
	char buffer_2[ ] = "name_3";
	char *lpStr2;
	lpStr2 = buffer_2;

	cout << "The original path string is    " << lpStr1 << endl;
	cout << "The part to append to end is   " << lpStr2 << endl;
	bool ret = PathAppend(lpStr1,lpStr2);
	cout << "The appended path string is    " << lpStr1 << endl;
}

OUTPUT:
--------- 
The original path string is    name_1\name_2
The part to append to end is   name_3
The appended path string is    name_1\name_2\name_3

Nota

L'intestazione shlwapi.h definisce PathAppend come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite