Structure STRRET (shtypes.h)

Contient les chaînes retournées par les méthodes d’interface IShellFolder .

Syntaxe

typedef struct _STRRET {
  UINT  uType;
  union {
    LPWSTR pOleStr;
    UINT   uOffset;
    char   cStr[260];
  } DUMMYUNIONNAME;
} STRRET;

Membres

uType

Type : UINT

Valeur qui spécifie le format souhaité de la chaîne. Il peut s’agir de l’une des valeurs suivantes.

STRRET_CSTR

La chaîne est retournée dans le membre cStr .

STRRET_OFFSET

La valeur du membre uOffset indique le nombre d’octets à partir du début de la liste d’identificateurs d’élément où se trouve la chaîne.

STRRET_WSTR

La chaîne se trouve à l’adresse spécifiée par le membre pOleStr .

DUMMYUNIONNAME

DUMMYUNIONNAME.pOleStr

Type : LPWSTR

Pointeur vers la chaîne. Cette mémoire doit être allouée avec CoTaskMemAlloc. Il incombe à l’application appelante de libérer cette mémoire avec CoTaskMemFree lorsqu’elle n’est plus nécessaire.

DUMMYUNIONNAME.uOffset

Type : UINT

Décalage dans la liste d’identificateurs d’élément.

DUMMYUNIONNAME.cStr[260]

Type : CHAR[MAX_PATH]

Mémoire tampon pour recevoir le nom d’affichage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête shtypes.h

Voir aussi

IShellFolder ::GetDisplayNameOf