IShellApp

アプリケーションに関する一般的な情報を「プログラムの追加と削除」アプリケーションに提供するメソッドを公開します。

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

型: HRESULT

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

実装では、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);
}

アプリケーションに対して許可される管理アクションのビットマスクを取得します。

型: HRESULT

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

APPACTIONFLAGS のビットマスクのうち、「プログラムの追加と削除」が認識するのは APPACTION_INSTALL と APPACTION_ADDLATER のみです。

低速なソースを起源とする情報をアプリケーションに返します。このメソッドは公開されたアプリケーションには適用されません。

型: HRESULT

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

IPublishedApp の実装は E_NOTIMPL を返す必要があります。このメソッドは、インストール済みアプリケーションに対して「プログラムの追加と削除」が内部的に使用します。

低速なソースを起源とする情報をアプリケーションに返します。IShellApp::GetSlowAppInfo とは異なり、このメソッドはキャッシュされた情報を返すことができます。このメソッドは公開されたアプリケーションには適用されません。

型: HRESULT

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

IPublishedApp の実装は E_NOTIMPL を返します。このメソッドは、インストール済みアプリケーションに対して「プログラムの追加と削除」が内部的に使用します。

指定されたアプリケーションが現在インストールされているかどうかを示す値を取得します。

型: HRESULT

このメソッドは次のいずれかの値を返すことがあります。

アプリケーションの発行元は、アプリケーションが現在インストールされているかどうかを判定し、インストールされている場合は S_OK を、そうでない場合は S_FALSE を返す必要があります。