Share via

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

  • Artigo

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)

Confira também

IQueryInfo