Funzione SHLocalStrDupA (shlwapi.h)

Articolo
11/20/2024

Crea una copia di una stringa nella memoria appena allocata.

Sintassi

HRESULT SHLocalStrDupA(
                  PCSTR psz,
  [out, optional] PSTR  *ppsz
);

Parametri

psz

Tipo: PCTSTR

Puntatore a una stringa Unicode con terminazione Null da copiare.

[out, optional] ppsz

Tipo: PTSTR*

L'indirizzo di un puntatore a una stringa allocata che, quando la funzione restituisce correttamente, riceve il risultato. SHLocalStrDup alloca memoria per questa stringa con LocalAlloc. È consigliabile liberare la stringa con LocalFree quando non è più necessaria.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Nota

L'intestazione shlwapi.h definisce SHLocalStrDup 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h

Condividi tramite