IShellApp::GetAppInfo メソッド (shappmgr.h)

アプリケーションに関する一般的な情報を取得します。

構文

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

パラメーター

[out] pai

種類: APPINFODATA*

アプリケーション情報を返す APPINFODATA 構造体へのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

メモコントロール パネルのプログラムの追加と削除により、APPINFODATA 構造体の cbSize メンバーと dwMask メンバーが設定されます。

 

実装では、 cbSize を APPINFODATA のサイズと比較して検証する必要があります。 cbSize が APPINFODATA のサイズと等しくない場合、このメソッドは E_FAIL などの COM エラー値を返す必要があります。

コントロール パネルのプログラムの追加と削除により、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