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

Obtiene el texto de información de un elemento.

Sintaxis

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

Parámetros

dwFlags

Tipo: DWORD

Marcas que dirigen el control del elemento desde el que se recupera el texto de la información. Este valor suele ser cero (QITIPF_DEFAULT). Se reconocen los siguientes valores.

QITIPF_DEFAULT (0x00000000)

Sin control especial.

QITIPF_USENAME (0x00000001)

Proporcione el nombre del elemento en ppwszTip en lugar del texto de la sugerencia de información.

QITIPF_LINKNOTARGET (0x00000002)

Si el elemento es un acceso directo, recupere el texto de información del acceso directo en lugar de su destino.

QITIPF_LINKUSETARGET (0x00000004)

Si el elemento es un acceso directo, recupere el texto de la sugerencia de información del destino del acceso directo.

QITIPF_USESLOWTIP (0x00000008)

Busque la información en todo el espacio de nombres. Este valor puede dar lugar a un tiempo de respuesta retrasado.

QITIPF_SINGLELINE (0x00000010)

Windows Vista y versiones posteriores. Coloque la sugerencia de información en una sola línea.

[out] ppwszTip

Tipo: PWSTR*

La dirección de un puntero de cadena Unicode que, cuando este método devuelve correctamente, recibe el puntero de cadena de propina. Las aplicaciones que implementan este método deben asignar memoria para ppwszTip mediante una llamada a CoTaskMemAlloc. Las aplicaciones que llaman a deben llamar a CoTaskMemFree para liberar la memoria cuando ya no sea necesaria.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si la función se realiza correctamente. Si no hay texto de información disponible, ppwszTip se establece en NULL. De lo contrario, devuelve un valor de error definido por COM.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 4.71 o posterior)

Consulte también

IQueryInfo