Funzione SHLocalStrDupW (shlwapi.h)

Articolo
08/26/2023

Crea una copia di una stringa nella memoria appena allocata.

Sintassi

HRESULT SHLocalStrDupW(
                  PCWSTR psz,
  [out, optional] PWSTR  *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 questa funzione viene restituita 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 .

Commenti

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 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


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h

Condividi tramite