Método IQueryInfo::GetInfoTip (shlobj_core.h)
Obtém o texto da dica de informações de um item.
Sintaxe
HRESULT GetInfoTip(
DWORD dwFlags,
[out] PWSTR *ppwszTip
);
Parâmetros
dwFlags
Tipo: DWORD
Sinalizadores que direcionam o tratamento do item do qual você está recuperando o texto da dica de informações. Esse valor geralmente é zero (QITIPF_DEFAULT). Os valores a seguir são reconhecidos.
QITIPF_DEFAULT (0x00000000)
Sem tratamento especial.
QITIPF_USENAME (0x00000001)
Forneça o nome do item em ppwszTip em vez do texto da dica de informações.
QITIPF_LINKNOTARGET (0x00000002)
Se o item for um atalho, recupere o texto da dica de informações do atalho em vez de seu destino.
QITIPF_LINKUSETARGET (0x00000004)
Se o item for um atalho, recupere o texto da dica de informações do destino do atalho.
QITIPF_USESLOWTIP (0x00000008)
Pesquise o namespace inteiro para obter as informações. Esse valor pode resultar em um tempo de resposta atrasado.
QITIPF_SINGLELINE (0x00000010)
Windows Vista e posteriores. Coloque a dica de informações em uma única linha.
[out] ppwszTip
Tipo: PWSTR*
O endereço de um ponteiro de cadeia de caracteres Unicode que, quando esse método retorna com êxito, recebe o ponteiro de cadeia de caracteres de dica. Os aplicativos que implementam esse método devem alocar memória para ppwszTip chamando CoTaskMemAlloc. Os aplicativos de chamada devem chamar CoTaskMemFree para liberar a memória quando ela não for mais necessária.
Retornar valor
Tipo: HRESULT
Retorna S_OK se a função for bem-sucedida. Se nenhum texto de dica de informação estiver disponível, ppwszTip será definido como NULL. Caso contrário, retorna um valor de erro definido por COM.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlobj_core.h |
| DLL | Shell32.dll (versão 4.71 ou posterior) |