Export (0) Print
Expand All

IShellApp::GetAppInfo method

Gets general information about an application.

Syntax


HRESULT GetAppInfo(
  [out]  APPINFODATA *pInfo
);

Parameters

pInfo [out]

Type: APPINFODATA*

A pointer to an APPINFODATA structure that returns the application information.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Note  Add/Remove Programs in the Control Panel sets the cbSize and dwMask members of the APPINFODATA structure.

Your implementation should validate cbSize by comparing it with the size of APPINFODATA. If cbSize does not equal the size of APPINFODATA, this method should return a COM error value like E_FAIL.

Add/Remove Programs in the Control Panel will set the dwMask member of the APPINFODATA structure to indicate that you should return AIM_DISPLAYNAME and AIM_SUPPORTURL. For each value that you return in APPINFODATA, you must set the corresponding bit in dwMask. All other bits should be cleared.

Examples

Here is a sample of how to use the 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);

}

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shappmgr.h

IDL

Shappmgr.idl

DLL

Shell32.dll

See also

IShellApp
APPINFODATA
IAppPublisher
IPublishedApp::GetPublishedAppInfo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft