Fonction SHStrDupA (shlwapi.h)
Effectue une copie d’une chaîne dans la mémoire nouvellement allouée.
Syntaxe
LWSTDAPI SHStrDupA(
[in] LPCSTR 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 retournée
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 à la chaîne copiée. Vous devez libérer cette mémoire avec CoTaskMemFree quand elle n’est plus nécessaire.
Notes
L’en-tête shlwapi.h définit SHStrDup en tant qu’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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| Bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |