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