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

Article
03/04/2024

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

Partager via