Funzione SHLocalStrDupW (shlwapi.h)
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 |