Fonction StrRetToStrN
Prend une structure STRRET retournée par IShellFolder::GetDisplayNameOf, la convertit en chaîne et place le résultat dans une mémoire tampon.
Syntaxe
BOOL StrRetToStrN(
_Out_ LPTSTR pszOut,
_In_ UINT cchOut,
_Inout_ LPSTRRET pStrRet,
_In_ LPCITEMIDLIST pidl
);
Paramètres
-
pszOut [out]
-
Type : LPTSTR
Mémoire tampon pour contenir le nom d’affichage. Elle est retournée sous la forme d’une chaîne terminée par un caractère Null. Si cchOut est trop petit, le nom est tronqué pour tenir.
-
cchOut [in]
-
Type : UINT
Taille de pszOut, en caractères. Si cchOut est trop petit, la chaîne est tronquée pour tenir.
-
pStrRet [in, out]
-
Type : LPSTRRET
Pointeur vers une structure STRRET . Lorsque la fonction retourne, ce pointeur n’est plus valide.
-
pidl [in]
-
Type : LPCITEMIDLIST
Pointeur vers la structure ITEMIDLIST de l’élément.
Valeur retournée
Type : BOOL
TRUE pour la réussite, FALSE en cas d’échec.
Notes
Notes
Depuis Shell32.dll version 5.0, l’appel de cette fonction revient à appeler StrRetToBuf.
StrRetToStrN n’est pas exporté par nom. Pour l’utiliser, vous devez utiliser GetProcAddress et demander l’ordinal 96 à partir de Shell32.dll pour obtenir un pointeur de fonction.
Si le membre uType de la structure pointée par pStrRet est défini sur STRRET_WSTR, le membre pOleStr de cette structure est libéré au retour.
Notez que cette fonction est exportée à partir de Shell32.dll plutôt que de Shlwapi.dll. Il est également inclus dans Shlobj.h plutôt que dans Shlwapi.h.
Spécifications
| 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] |
| DLL |
|
Voir aussi