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)

Voir aussi

IShellFolder ::GetDisplayNameOf

StrRetToBuf

StrRetToStr