IShellApp：：GetAppInfo 方法 (shappmgr.h)

  • 项目

获取有关应用程序的常规信息。

语法

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

参数

[out] pai

类型： APPINFODATA*

指向返回应用程序信息的 APPINFODATA 结构的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

注意在 控制面板中添加/删除程序设置 APPINFODATA 结构的 cbSize 和 dwMask 成员。
 
实现应通过将 cbSize 与 APPINFODATA 的大小进行比较来验证 cbSize。 如果 cbSize 不等于 APPINFODATA 的大小，此方法应返回 COM 错误值，如 E_FAIL。

在控制面板中添加/删除程序将设置 APPINFODATA 结构的 dwMask 成员，以指示应返回AIM_DISPLAYNAME和AIM_SUPPORTURL。 对于在 APPINFODATA 中返回的每个值，必须在 dwMask 中设置相应的位。 应清除所有其他位。

示例

下面是如何使用 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);

}

要求

要求 值
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shappmgr.h
DLL Shell32.dll

另请参阅

APPINFODATA

IAppPublisher

IPublishedApp：：GetPublishedAppInfo

IShellApp