Método IShellApp::GetAppInfo (shappmgr.h)

  • Artigo

Obtém informações gerais sobre um aplicativo.

Sintaxe

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parâmetros

[out] pai

Tipo: APPINFODATA*

Um ponteiro para uma estrutura APPINFODATA que retorna as informações do aplicativo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Nota Adicionar/remover programas no Painel de Controle define os membros cbSize e dwMask da estrutura APPINFODATA.
 
Sua implementação deve validar cbSize comparando-a com o tamanho de APPINFODATA. Se cbSize não for igual ao tamanho de APPINFODATA, esse método deverá retornar um valor de erro COM como E_FAIL.

Adicionar/Remover Programas no Painel de Controle definirá o membro dwMask da estrutura APPINFODATA para indicar que você deve retornar AIM_DISPLAYNAME e AIM_SUPPORTURL. Para cada valor retornado em APPINFODATA, você deve definir o bit correspondente em dwMask. Todos os outros bits devem ser limpos.

Exemplos

Aqui está um exemplo de como usar os bits dwMask::

HRESULT CPubApp::GetAppInfo(APPINFODATA *pData)
{
    if (sizeof(APPINFODATA) != pData->cbSize)
        return E_FAIL;

    // First save off the mask of requested data items.

    const DWORD dwMask = pData->dwMask;

    // Zero-out the mask.  Bits will be set as items are obtained. 

    pData->dwMask = 0;

    // Call an internal function that obtains data and sets
    // bits in pData->dwMask for each item obtained.

    return get_app_info_data(pData, dwMask);

}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shappmgr.h
DLL Shell32.dll

Confira também

APPINFODATA

IAppPublisher

IPublishedApp::GetPublishedAppInfo

IShellApp