SHStrDupW, fonction (shlwapi.h)
Effectue une copie d’une chaîne dans la mémoire nouvellement allouée.
Syntaxe
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
Paramètres
[in] psz
Type : LPCTSTR
Pointeur vers la chaîne terminée par null à copier.
[out] ppwsz
Type : LPTSTR*
Pointeur vers une chaîne Unicode allouée qui contient le résultat. SHStrDup alloue de la mémoire pour cette chaîne avec CoTaskMemAlloc. Vous devez libérer la chaîne avec CoTaskMemFree quand elle n’est plus nécessaire.
En cas d’échec, cette valeur est NULL.
Valeur de retour
Type : HRESULT
Retourne S_OK en cas de réussite ou une valeur d’erreur COM dans le cas contraire.
Remarques
Cette fonction prend des chaînes Unicode ou ANSI comme entrée, mais la chaîne copiée est toujours Unicode.
Cette fonction utilise CoTaskMemAlloc pour allouer de la mémoire pour la chaîne copiée. Vous devez libérer cette mémoire avec CoTaskMemFree quand elle n’est plus nécessaire.
Note
L’en-tête shlwapi.h définit SHStrDup comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | shlwapi.h |
| bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |