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

  • Artículo

Obtiene información general sobre una aplicación.

Sintaxis

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parámetros

[out] pai

Tipo: APPINFODATA*

Puntero a una estructura APPINFODATA que devuelve la información de la aplicación.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Nota Agregar o quitar programas en el Panel de control establece los miembros cbSize y dwMask de la estructura APPINFODATA.
 
La implementación debe validar cbSize comparándola con el tamaño de APPINFODATA. Si cbSize no es igual al tamaño de APPINFODATA, este método debe devolver un valor de error COM como E_FAIL.

Agregar o quitar programas en el Panel de control establecerá el miembro dwMask de la estructura APPINFODATA para indicar que debe devolver AIM_DISPLAYNAME y AIM_SUPPORTURL. Para cada valor devuelto en APPINFODATA, debe establecer el bit correspondiente en dwMask. Todos los demás bits deben borrarse.

Ejemplos

Este es un ejemplo de cómo usar dwMask bits::

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 Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shappmgr.h
Archivo DLL Shell32.dll

Consulte también

APPINFODATA

IAppPublisher

IPublishedApp::GetPublishedAppInfo

IShellApp