Méthode IQueryInfo ::GetInfoTip (shlobj_core.h)

  • Article

Obtient le texte d’info-conseil d’un élément.

Syntaxe

HRESULT GetInfoTip(
        DWORD dwFlags,
  [out] PWSTR *ppwszTip
);

Paramètres

dwFlags

Type : DWORD

Indicateurs qui dirigent la gestion de l’élément à partir duquel vous récupérez le texte du conseil d’informations. Cette valeur est généralement zéro (QITIPF_DEFAULT). Les valeurs suivantes sont reconnues.

QITIPF_DEFAULT (0x00000000)

Pas de manipulation spéciale.

QITIPF_USENAME (0x00000001)

Indiquez le nom de l’élément dans ppwszTip plutôt que le texte d’info-conseil.

QITIPF_LINKNOTARGET (0x00000002)

Si l’élément est un raccourci, récupérez le texte du conseil d’informations du raccourci plutôt que sa cible.

QITIPF_LINKUSETARGET (0x00000004)

Si l’élément est un raccourci, récupérez le texte d’info-bulle de la cible du raccourci.

QITIPF_USESLOWTIP (0x00000008)

Recherchez les informations dans l’espace de noms entier. Cette valeur peut entraîner un délai de réponse retardé.

QITIPF_SINGLELINE (0x00000010)

Windows Vista et versions ultérieures. Placez le conseil d’informations sur une seule ligne.

[out] ppwszTip

Type : PWSTR*

Adresse d’un pointeur de chaîne Unicode qui, lorsque cette méthode retourne correctement, reçoit le pointeur de chaîne de pointe. Les applications qui implémentent cette méthode doivent allouer de la mémoire pour ppwszTip en appelant CoTaskMemAlloc. Les applications appelantes doivent appeler CoTaskMemFree pour libérer la mémoire quand elle n’est plus nécessaire.

Valeur retournée

Type : HRESULT

Retourne S_OK si la fonction réussit. Si aucun texte d’info-conseil n’est disponible, ppwszTip a la valeur NULL. Sinon, retourne une valeur d’erreur définie par COM.

Configuration requise

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]
Plateforme cible Windows
En-tête shlobj_core.h
DLL Shell32.dll (version 4.71 ou ultérieure)

Voir aussi

IQueryInfo