Funzione SHStrDupW (shlwapi.h)
Crea una copia di una stringa nella memoria appena allocata.
Sintassi
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
Parametri
[in] psz
Tipo: LPCTSTR
Puntatore alla stringa con terminazione Null da copiare.
[out] ppwsz
Tipo: LPTSTR*
Puntatore a una stringa Unicode allocata che contiene il risultato. SHStrDup alloca memoria per questa stringa con CoTaskMemAlloc. È consigliabile liberare la stringa con CoTaskMemFree quando non è più necessaria.
In caso di errore, questo valore è NULL.
Valore restituito
Tipo: HRESULT
Restituisce S_OK in caso di esito positivo o un valore di errore COM in caso contrario.
Osservazioni
Questa funzione accetta stringhe Unicode o ANSI come input, ma la stringa copiata è sempre Unicode.
Questa funzione usa CoTaskMemAlloc per allocare memoria per la stringa copiata. È necessario liberare questa memoria con CoTaskMemFree quando non è più necessario.
Nota
L'intestazione shlwapi.h definisce SHStrDup 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 5.0 o successiva) |