Fonction StrRetToBSTR (shlwapi.h)
Accepte une structure STRRET retournée par IShellFolder ::GetDisplayNameOf qui contient ou pointe vers une chaîne, et retourne cette chaîne en tant que BSTR.
Syntaxe
LWSTDAPI StrRetToBSTR(
[in, out] STRRET *pstr,
[in] PCUITEMID_CHILD pidl,
[out] BSTR *pbstr
);
Paramètres
[in, out] pstr
Type : STRRET*
Pointeur vers une structure STRRET . Lorsque la fonction retourne, ce pointeur est plus valide.
[in] pidl
Type : PCUITEMID_CHILD
Pointeur vers un ITEMIDLIST qui identifie de manière unique un objet de fichier ou un sous-dossier par rapport au dossier parent. Cette valeur peut être NULL.
[out] pbstr
Type : BSTR*
Pointeur vers une variable de type BSTR qui reçoit la chaîne convertie.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Si le membre uType de la structure STRRET pointée par pstr est défini sur STRRET_WSTR, le membre pOleStr de cette structure est libéré au retour.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| Bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.5 ou ultérieure) |