Funzione PathAppendA (shlwapi.h)

Articolo
11/20/2024

Aggiunge un percorso alla fine di un altro.

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

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 che contiene il percorso da aggiungere.

Valore restituito

Tipo: bool

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

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

Il percorso fornito in pszPath non può iniziare con ".. \" o ".\" per produrre una stringa di percorso relativa. Se presente, tali punti vengono rimossi dalla stringa di output. Ad esempio, aggiungendo "path3" a ".. \path1\path2" restituisce un output di "\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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite