Lire en anglais

Partager via


EnumMRUListW, fonction

[Cette fonction est disponible via Windows XP avec Service Pack 2 (SP2) et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows. ]

Énumère le contenu de la liste la plus récente utilisée (MRU). Récupère éventuellement un élément de l’énumération.

Syntaxe

int EnumMRUListW(
  _In_  HANDLE hMRU,
  _In_  int    nItem,
  _Out_ void   *lpData,
  _In_  UINT   uLen
);

Paramètres

hMRU [in]

Type : HANDLE

Handle de la liste MRU, obtenu lors de la création de la liste.

nItem [in]

Type : int

Élément à retourner. Si cette valeur est inférieure à 0, la fonction retourne le nombre d’éléments dans la liste MRU.

lpData [out]

Type : void*

Pointeur vers une mémoire tampon qui reçoit l’élément demandé dans nItem. Si nItem est inférieur à 0, le contenu de cette mémoire tampon est inchangé.

uLen [in]

Type : UINT

Taille de la mémoire tampon, y compris le caractère null de fin. Si la liste MRU a été créée avec l’indicateur MRU_BINARY , il s’agit de la taille en octets. Sinon, il s’agit de la taille en caractères.

Valeur retournée

Type : int

Retourne l’une des valeurs suivantes.

  • Retourne le nombre d’éléments dans l’énumération, si nItem est inférieur à 0.
  • Retourne -1 si une erreur s’est produite.
  • Sinon, retourne la taille de la chaîne retournée dans lpData, y compris le caractère null de fin. Si la liste MRU a été créée avec l’indicateur MRU_BINARY , il s’agit de la taille en octets. Sinon, il s’agit de la taille en caractères.

Notes

Cette fonction n’est pas incluse dans un en-tête public ou une bibliothèque. Il est accessible via GetProcAddress ou extrait de comctl32.dll par son ordinal, qui est 403 pour EnumMRUListW.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
DLL
Comctl32.dll (version 5.0 ou ultérieure)
Noms Unicode et ANSI
EnumMRUListW (Unicode)

Voir aussi

CreateMRUListW

MRUINFO