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

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

構文

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parameters

[out] pai

型: APPINFODATA*

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

戻り値

型: HRESULT

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

注釈

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

コントロール パネルのプログラムの追加と削除では、AIM_DISPLAYNAMEとAIM_SUPPORTURLを返す必要があることを示すAPPINFODATA 構造体の dwMask メンバーが設定されます。 APPINFODATA で返される値ごとに、dwMask で対応するビットを設定する必要があります。 その他のビットはすべてクリアする必要があります。

Examples

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);
}

Requirements

こちらも参照ください

• APPINFODATA
• IAppPublisher
• IPublishedApp::GetPublishedAppInfo
• IShellApp