クライアントの種類にプログラムを登録する

[アーティクル]
12/19/2023

このトピックでは、ブラウザー、電子メール、メディア再生、インスタントメッセージング、または Java 用仮想マシンのいずれかのクライアントの種類として、Windows レジストリにプログラムを登録する方法について説明します。

Note

このドキュメントに記載された情報の対象となるオペレーティングシステムは次のとおりです。

Windows 2000 Service Pack 3 (SP3)
Windows 2000 Service Pack 4 (SP4)
Windows XP Service Pack 1 (SP1)
Windows XP Service Pack 2 (SP2)
Windows XP Service Pack 3 (SP3)
Windows Server 2003
Windows Vista
Windows Vista Service Pack 1 (SP1)
Windows 8

このトピックは次のセクションで構成されます。

すべてのクライアントの種類の共通登録要素
特定のクライアントの種類の登録要素
- スタートメニューの登録
- メールクライアントの登録
完全なサンプルの登録
関連トピック

このトピックでは、特定のクライアントの種類としてプログラムを登録する方法に関する既存のドキュメントを拡張します。そのドキュメントへのリンクについては、「関連トピック」セクションを参照してください。

すべてのクライアントの種類の共通登録要素

プログラムをクライアントの種類として登録する場合、ほとんどのレジストリエントリは、クライアントの種類に関係なく同じです。ただし、一部のレジストリエントリはクライアントの種類に固有であり、「特定のクライアントの種類の登録要素」セクションに記載されています。

このセクションでは、次のトピックについて説明します。

正規名の選択
プログラムの表示名の登録
プログラムのアイコンの登録
オープン動詞の登録
インストール情報の登録

Note

このトピック全体で斜体で指定されたサブキー名は、ユーザー定義のサブキー名または使用可能な値のセットのプレースホルダーです。サンプル名を含む完全な例については、「完全なサンプルの登録」セクションを参照してください。

すべてのクライアントの種類の登録情報は、次のサブキーの下に格納されます。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName

ClientTypeName は、次のいずれかのサブキー名です。

StartMenuInternet (ブラウザー用)
Mail (メール用)
Media (メディア再生用)
IM (インスタントメッセージング用)
JavaVM (Virtual Machin for Java 用)

このトピックでは、Litview.exe という名前の実行可能ファイルを使用して、Litware Inc.の "Lit View" という名前の架空のコンピュータープログラムへの参照を書き留めます。この架空のプログラムは、説明目的で必要に応じて、インスタントメッセンジャー、ブラウザ、または別の種類のクライアントプログラムとして同じ意味で使用されます。

正規名の選択

ベンダーは、プログラムの正規名を選択する必要があります。正規名はユーザーに表示されないため、ローカライズする必要はありません。その唯一の目的は、プログラムを識別するために使用できる一意の文字列を提供することです。通常、プログラムの英語名と同じですが、これは単なる慣例です。

ブラウザー以外のクライアント型の場合、正規名には任意の文字列を指定できます。別のベンダーが使用する可能性が高くない一意の名前を選択します。

ブラウザークライアントの場合、標準名は、関連付けられている実行可能ファイルの名前 (拡張子を含む) である必要があります。たとえば、"Litview.exe" です。

正規名の例をいくつか次に示します。

Iexplore.exe (ブラウザー)
Windows Mail (電子メール)
Windows Media Player (メディア)
Windows Messenger (インスタントメッセージング)

次に示すように、サブキーを作成して正規名を登録します。サブキーの名前は正規名です。そのプログラムの登録に関連するすべての情報は、このサブキーの下に存在します。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName

プログラムの表示名の登録

登録の次の手順は、プログラムの表示名を指定することです。次に示すように、正規名キーの下に値として指定されます。ここでも、CanonicalName と ClientTypeName はキーの実際の名前ではなく、Lit View などの真の名前のプレースホルダーにすぎないことに注意してください。

Note

Windows 8 の時点で、[コンピューターの設定 (SPAD)] と [既定のプログラム] の登録に使用される名前は、SPAD の変更が既定のプログラムの登録をトリガーするために一致する必要があります。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               LocalizedString = @FilePath,-StringID

LocalizedString 値は REG_SZ 文字列であり、"at" 記号 (@)、.dll または .exe ファイルへの完全なパス、コンマ、負符号、および 10 進整数で構成されます。 10 進整数は、.dll または .exe ファイル内に含まれる文字列リソースの ID であり、その値は、このクライアントの名前としてユーザーに表示されます。ファイルパスにスペースが含まれている場合でも、引用符は必要ありません。

この方法で表示名文字列を登録すると、複数の言語で同じ登録を使用できます。各言語インストールでは、同じリソース ID に格納されている表示名を持つ異なるリソースファイルが提供されます。

次の例は、架空の Lit View インスタントメッセージングプログラムの登録を示しています。インスタントメッセージングプログラムであるため、CanonicalName サブキー (この場合は Lit View) は IM サブキーの下に格納されます。

HKEY_LOCAL_MACHINE
   Software
      Clients
         IM
            Lit View
               (Default) = Lit View
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123

クライアントの表示名のセカンダリ宣言として (Default) エントリを使用していることに注意してください。 LocalizedString が存在しない場合は、代わりに (Default) 値が使用されます。これは、すべてのクライアントの種類 (インターネットブラウザー、電子メールブラウザー、インスタントメッセンジャー、メディアプレーヤー) で動作します。 Internet Explorer クライアントレジストリレイアウトとの下位互換性を保つために、電子メールプログラムでは、CanonicalName サブキーの (既定値) 値を、現在インストールされている言語でクライアントの表示名に設定する必要があります。

プログラムのアイコンの登録

Note

このセクションは Windows 2000 には適用されません。

既定では、Windows XP と Windows Vista の [スタート] メニューの上部には、[インターネット] と [電子メール] のアイコンが含まれています。これらのアイコンは、Windows 7 以降には存在しません。ブラウザーおよび電子メールクライアントの場合、プログラムがクライアントの種類の既定値として割り当てられると、そのプログラムの登録アイコンがそれらの [スタート] メニューエントリに表示されます。

ブラウザーおよび電子メールクライアントでは、プログラムのアイコンの登録が必須です。 Java クライアントの種類のメディア再生、インスタントメッセージング、または仮想マシンのアイコンの登録は省略可能であり、これらのクライアントの種類の登録済みアイコンは現在 Windows では使用されず、Windows XP または Windows Vista の [スタート] メニューの上部には表示されません。

クライアントプログラムのアイコンを登録するには、次に示すように既定値を持つ DefaultIcon サブキーを追加します。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               DefaultIcon
                  (Default) = FilePath,IconIndex

FilePath 値は、アイコンを含むファイルへの完全なパスです。このパスには、スペースが含まれている場合でも、引用符は必要ありません。

IconIndex 値は次のように解釈されます。

IconIndex が正の数である場合、この数は、ファイルに格納されているアイコンの 0 から始まる配列のインデックスとして使用されます。たとえば、IconIndex が 1 の場合、2 番目のアイコンがファイルから読み込まれます。
IconIndex が負の数の場合、アイコンのリソース識別子 (インデックスではなく) として IconIndex の絶対値が使用されます。たとえば、IconIndex が -3 の場合、リソース識別子が 3 のアイコンがファイルから読み込まれます。

次の例は、架空の Lit View ブラウザーの登録を示しています。 Litview.exe ファイルに格納されている 2 番目のアイコンが既定として使用されます。

HKEY_LOCAL_MACHINE
   Software
      Clients
         StartMenuInternet
            LITVIEW.EXE
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\Litview.exe,1

オープン動詞の登録

Note

このセクションは Windows 2000 には適用されません。次の手順は、ブラウザーと電子メールクライアントにのみ必要です。

ユーザーが既定のインターネットまたは電子メールプログラムとしてプログラムを選択したとします。そのユーザーは、Windows XP または Windows Vista の [スタート] メニューの [インターネット] または [電子メール] アイコンをクリックしてプログラムを開きます。その時点で、ここに示すように登録されたコマンドラインが実行されます。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               shell
                  open
                     command
                        (Default) = command line

コマンドラインでは、ファイルへの完全修飾絶対パスを指定し、その後にオプションのコマンドラインオプションを指定する必要があります。エントリの種類が REG_EXPAND_SZ の場合は、パスで環境変数を使用できます。コマンドライン内のスペースが誤って解釈されないように、引用符を適切に使用します。コマンドラインは、適切な既定値でプログラムを実行する必要があります。通常、ブラウザーはユーザーのホームページに既定で設定されます。電子メールプログラムは通常、ユーザーの [受信トレイ] を開きます。

次の例は、架空の Lit View ブラウザーの open 動詞の登録を示しています。コマンドラインオプションは指定されません。

HKEY_LOCAL_MACHINE
   Software
      Clients
         StartMenuInternet
            LITVIEW.EXE
               shell
                  open
                     command
                        (Default) = "C:\Program Files\LitwareInc\Litview.exe"

この値では、埋め込みスペースが含まれているため、パスの周囲に引用符が配置されることに注意してください。これらの引用符を省略すると、コマンドラインが誤って解釈される可能性があります。

インストール情報の登録

Note

このセクションは、Windows Server 2003 には適用されません。

再インストールコマンド
[アイコンの非表示] コマンド
[アイコンの表示] コマンド
グループプログラムの構成
ブラウザー登録の例

次の表に示すように、ユーザーがコンピューターごとの既定のプログラムを選択する機能に名前が付けられ、アクセスされます。 (Windows Vista では、新しい機能 [Set your default programs] (既定のプログラムを設定する) が導入されました。ユーザーごとの既定値を設定できます)。

オペレーティングシステム	Title	アクセス場所
Windows 7	プログラムアクセスとコンピューターの既定値を設定する	[スタート] メニューの [既定のプログラム] オプション [既定のプログラム] コントロールパネルのアイテム
Windows Vista	プログラムアクセスとコンピューターの既定値を設定する	[スタート] メニューの [既定のプログラム] オプション [既定のプログラム] コントロールパネルのアイテム
Windows XP SP2	プログラムのアクセスと既定値を設定する	[スタート] メニュー [プログラムの追加と削除] コントロールパネルのアイテム
Windows XP SP1	プログラムの構成	[プログラムの追加と削除] コントロールパネルのアイテム

わかりやすくするために、このトピックではこの機能の Windows 7 タイトルを使用します。この機能のすべてのバージョンは、一般的に SPAD と呼ばれます。

Note

Windows 2000 または Windows XP を実行している場合、[コンピューターの既定] ページを表示するには、Windows 2000 SP3 または Windows XP SP1 以上がインストールされている必要があります。 Windows Vista 以降では、[コンピューターの既定] ページへのアクセスには管理者権限が必要です。このため、開発者は、すべてのユーザーがアプリケーションの既定値を管理できるように、[既定のプログラムの設定] コントロールパネル項目に登録することをお勧めします。

次のレジストリツリーは、プログラムの InstallInfo キーに登録する必要があるさまざまな情報を示しています。これによりプログラムは、[コンピューターの既定] ページにクライアントの種類のオプションとして表示されます。これらの各値については、次のセクションで詳しく説明します。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               InstallInfo
                  HideIconsCommand = command line
                  ReinstallCommand = command line
                  ShowIconsCommand = command line
                  IconsVisible = 1

コマンドラインでは、ファイルへの完全修飾絶対パスを指定し、その後にオプションのコマンドラインオプションを指定する必要があります。コマンドライン内のスペースが誤って解釈されないように、引用符を適切に使用します。

再インストールコマンド

ReinstallCommand 値で宣言された再インストールコマンドラインは、ユーザーが [コンピューターの既定] ページを使用して、クライアントの種類の既定値としてプログラムを選択するときに実行されます。 Windows Vista 以降では、このページへのアクセスには管理者特権レベルが必要です。 Windows 8 では、[コンピューターの既定] と [既定のプログラム] の両方に同じ名前を使用してアプリケーションを登録した場合、そのアプリケーションの [既定のプログラム] で指定された既定値が現在のユーザーに適用され、再インストールコマンドが実行されます。

再インストールコマンドラインによって起動されたプログラムは、アプリケーションが処理できるファイルとプロトコルの種類の完全なセットにアプリケーションを関連付ける必要があります。すべてのアプリケーションでは、再インストールコマンドでハンドラー機能を確立する必要があります。アプリケーションでは、再インストールコマンドを使用して機能を登録したり、必要に応じて既定の状態を確立したりできます。アプリケーションが再インストールコマンドで機能と既定のハンドラーの状態の両方を実装することを選択した場合は、必要に応じて表示されるリンクやショートカットも元に戻す必要があります。ほとんどのアプリケーションが選択する表示されるエントリポイントは、[アイコンの非表示] コマンドに一覧表示されます。

Note

アプリケーションでは、再インストールコマンドで処理機能を実装することを強くお勧めします。

再インストールプロセスが完了すると、再インストールコマンドラインによって起動されたプログラムが終了します。対応するプログラムは起動されません。単に既定値が登録されます。たとえば、ブラウザーの再インストールコマンドは、ユーザーのホームページを開きません。

Note

Windows XP および Windows Vista のブラウザーおよび電子メールクライアントの場合、再インストールコマンドで処理機能と既定の状態の両方を確立することを選択したアプリケーションは、[スタート] メニューの上部にある対応するアイコンに登録します。詳細については、「スタートメニューの登録」を参照してください。

[アイコンの非表示] コマンド

HideIconsCommand 値で宣言されたコマンドラインは、ユーザーが [コンピューターの既定] ページで [Enable access to this program] (このプログラムへのアクセスを有効にする) ボックスをオフにすると実行されます。このコマンドラインでは、ユーザーインターフェイスに表示されるすべてのプログラムのアクセスポイントを非表示にする必要があります。具体的なガイドラインは、次の場所からショートカットとアイコンを削除することです。

デスクトップアイコン
[スタート] メニューのリンク (スタートアップ グループを含む)
サイドリンクバーのリンク
通知領域
ショートカットメニュー
フォルダータスクバンド

また、このコマンドラインでは、Run レジストリキーで指定されているプログラムなどの自動呼び出しを防ぐ必要があります。ベンダーでは、アプリケーションの Hide Access コールバックにこれらのガイドラインを実装することをお勧めします。

アイコンが非表示になっている場合、ファイルの種類の登録 (アプリケーション機能) を放棄する必要はありません。また、ファイルとプロトコルの種類に対するアプリケーションの既定の状態を放棄する必要はありません。これにより、UI でこれらの型が検出されると、ユーザーエクスペリエンスが低下する可能性があります。

アイコンを正常に非表示にしたら、次のように IconsVisible レジストリ値を 0 に更新する必要があります。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               InstallInfo
                  IconsVisible = 0

IconsVisible エントリの種類は REG_DWORD です。

SPAD の代替非表示アイコンメソッド

一部のレガシアプリケーションでは、Hide Access の完全な実装は実用的でない場合があります。同じ効果を実現する別の方法は、アプリケーションをアンインストールすることです。次のセクションでは、この代替手段を実装するための動作の例とサンプルコードを示します。一般に、独立系ソフトウェアベンダー (ISV) は、次のことを行うので、この代替手段を回避する必要があります。

システムからアプリケーションを完全にアンインストールします。
以前に選択した既定値を削除します。
アプリケーションを再インストールする UI オプションは残しません。
アンインストールによってアプリケーションが SPAD から完全に削除されるため、アクセスの有効化機能を使用できなくなります。

推奨されるユーザーエクスペリエンスは次のとおりです。

ユーザーが SPAD の [Enable access to this program] (このプログラムへのアクセスを有効にする) ボックスをオフにすると、次の UI が表示されます。
ユーザーが [OK] を選択すると、[プログラムと機能] コントロールパネルの項目が起動して、ユーザーがアプリケーションをアンインストールできるようになります。
Windows XP ユーザーには、このダイアログボックスが表示されます。
Windows XP ユーザーが [OK] を選択すると、[プログラムの追加と削除] コントロールパネル項目が起動して、ユーザーがアプリケーションをアンインストールできるようになります。

次のコードは、前述のように、アクセスを非表示にする機能の再利用可能な実装を提供します。 Windows XP、Windows Vista、Windows 7 で使用できます。

#include <windows.h>
#include <shlwapi.h>
#include <strsafe.h>

PCWSTR c_pszMessage1 = L"To hide access to this program, you need to uninstall it by ";
PCWSTR c_pszMessage2 = L"using\n%s in Control Panel.\n\nWould you like to start %s?";
PCWSTR c_pszApplicationName  = L"Sample App";

int _tmain(int argc, WCHAR* argv[])
{
    OSVERSIONINFO version;
    version.dwOSVersionInfoSize = sizeof(version);

    if (GetVersionEx(&version))
    {
        PCWSTR pszCPLName = NULL;

        if (version.dwMajorVersion >= 6)
        {
            // Windows Vista and later
            pszCPLName = L"Programs and Features";
        }
        else if (version.dwMajorVersion == 5 &&
                 version.dwMinorVersion == 1)
        {
            // Windows XP
            pszCPLName = L"Add/Remove Programs";
        }

        if (pszCPLName != NULL)
        {
            WCHAR szMessage[256], szScratch[256];
            if (SUCCEEDED(StringCchPrintf(szScratch, 
                                          ARRAYSIZE(szScratch), 
                                          c_pszMessage2, 
                                          pszCPLName, 
                                          pszCPLName)))
            {
                if (SUCCEEDED(StringCchCopy(szMessage, 
                                            ARRAYSIZE(szMessage), 
                                            c_pszMessage1)))
                {
                    if (SUCCEEDED(StringCchCat(szMessage, 
                                               ARRAYSIZE(szMessage), 
                                               szScratch)))
                    {
                        if (IDOK == MessageBox(NULL, 
                                               szMessage, 
                                               c_pszApplicationName, 
                                               MB_OKCANCEL))
                        {
                            ShellExecute(NULL, 
                                         NULL, 
                                         L"appwiz.cpl", 
                                         NULL, 
                                         NULL, 
                                         SW_SHOWNORMAL);
                        }
                    }
                }
            }
        }
    }
    return 0;
}

[アイコンの表示] コマンド

ShowIconsCommand エントリで宣言されたコマンドラインは、ユーザーが [コンピューターの既定] ページで [Enable access to this program] (このプログラムへのアクセスを有効にする) ボックスをオンにすると実行されます。このコマンドラインでは、[スタート] メニュー、デスクトップ、[スタートアップ] グループのアクセスポイントや、Run レジストリキーで指定された通常の自動呼び出しなど、プログラムのアクセスポイントが復元される場合があります。ほとんどのアプリケーションに表示されるアクセスポイントは、[アイコンの非表示] コマンドに表示されます。アプリケーションはユーザーごとの既定値を変更しないでください。その変更は、[既定のプログラム] を使用してユーザーが行う必要があります。

アイコンが正常に表示されたら、次のように IconsVisible レジストリ値を 1 に更新する必要があります。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               InstallInfo
                  IconsVisible = 1

HideIconsCommand エントリを使用してアプリケーションのアンインストールを求めるメッセージを表示した場合、ShowIconsCommand エントリは使用されません。アンインストールプロセス中に、アプリケーションの残りの情報と共にレジストリから削除されます。

グループプログラムの構成

Note

このセクションは Windows 2000 には適用されません。

システム準備の一環として、OEM は、Java クライアントプログラムの Microsoft ブラウザー、電子メール、メディア再生、インスタントメッセージング、または仮想マシンのアクセスポイントを非表示にし、独自の既定のプログラムを指定する構成を確立できます。 OEM は、次のレジストリ値を設定することで、ユーザーがコンピューターをいつでもこの既定の構成にリセットできるようにします。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            CanonicalName
               InstallInfo
                  OEMShowIcons = 1
                  OEMDefault = 1

これらのキーが設定されている場合、ユーザーは、[コンピューターの既定] ページの [コンピューターの製造元] オプションを選択して OEM 構成を復元できます。これらのキーが設定されていない場合、[コンピューターの製造元] オプションは表示されません。

OEMShowIcons エントリが存在する場合は、ユーザーが [コンピューターの製造元] を選択した場合に適用される、指定したクライアントのアイコンの表示状態を設定します。値が 1 の場合はアイコンが表示され、値 0 の場合はアイコンが表示されません。 OEMShowIcons が存在しない場合は、[コンピューターの製造元] を選択しても、アイコンの表示設定には影響しません。 OEMShowIcons は REG_DWORD 型です。

OEMDefault エントリが存在し、1 に設定されている場合は、指定された種類の既定のクライアントの OEM 基本設定を確立します。特定の種類のクライアントを OEM の既定値としてマークできるのは 1 つだけです。複数のクライアントの登録に OEMDefault エントリが含まれている場合は、すべて無視され、現在のクライアントは引き続き既定のクライアントとして使用されます。 OEMDefault エントリが存在しないか、存在しても 0 に設定されている場合、ユーザーが [コンピューターの製造元] を選択した場合、その特定のクライアントは既定のクライアントとして使用されません。 OEMDefault は REG_DWORD 型です。

OEM によって確立された既定の構成にコンピューターをリセットするオプションに加えて、ユーザーには他に 3 つの構成オプションがあります。

コンピューターを Microsoft Windows 構成に設定します。この場合、[コンピューターの既定] ページでは、関連する製品カテゴリに登録されているコンピューター上のすべての Microsoft および Microsoft 以外のソフトウェアにアクセスできます。 Microsoft Windows プログラムは、各カテゴリの既定のオプションとして選択されます。
コンピューターを Microsoft 以外の構成に設定します。この構成では、Windows Internet Explorer、Windows Media Player、Windows Messenger、Microsoft Outlook Express へのアクセスポイント ([スタート] メニューなど) が非表示になります。これらのカテゴリのコンピューター上の Microsoft 以外のソフトウェアにアクセスできます。さらに、Microsoft 以外のプログラムをカテゴリで使用できる場合は、そのカテゴリの既定値として設定されます。カテゴリで複数の Microsoft 以外のプログラムを使用できる場合、ユーザーは既定として使用する Microsoft 以外のプログラムを選択するように求められます。
カスタム構成を確立します。ユーザーは、アクセスを有効または削除し、Microsoft と Microsoft 以外のプログラムを組み合わせて、必要に応じて独自の選択を行います。ユーザーは、カテゴリごとに既定のオプションを設定します。

ユーザーはいつでもこれらのオプションを自由に変更できます。

ブラウザー登録の例

次の例は、架空の Lit View ブラウザーの完全な InstallInfo 登録を示しています。この場合、コマンドラインスイッチを使用すると、Litview.exe ファイルは値ごとに必要な操作を実行できます。

HKEY_LOCAL_MACHINE
   Software
      Clients
         StartMenuInternet
            LITVIEW.EXE
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\Litview.exe" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\Litview.exe" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\Litview.exe" /showicons
                  IconsVisible = 1

引用符は埋め込みスペースを含んでいるため、パスの周囲に配置されることに注意してください。

特定のクライアントの種類の登録要素

次の情報は、このトピックの最後にある「関連トピック」セクションに記載されているリソースにも記載されています。

スタートメニューの登録
メールクライアントの登録

Windows XP では、アプリケーションは通常、ユーザー (HKEY_CURRENT_USER) スコープではなく、コンピューター全体 (HKEY_LOCAL_MACHINE) に既定で登録されます。 Windows Vista でユーザーアカウント制御 (UAC) が導入された場合、[スタート] メニューで [インターネット] と [電子メール] スロットを要求するアプリケーションは、正しい実行コンテキスト内で再インストールコマンドを実装する必要があります。

Note

Windows 7 の時点で、[スタート] メニューの [電子メール] リンクが削除されました。ただし、このセクションで説明する登録は、既定の MAPI クライアントを割り当てるので、引き続き実行する必要があります。

Windows XP、Windows Vista、または Windows 7 の制限付きユーザーは SPAD にアクセスできません。このため、開発者は、すべてのユーザーがユーザーごとのアプリケーションの既定値を管理できるように、[既定のプログラムの設定] コントロールパネル項目に登録することをお勧めします。

SPAD で行われた選択は、マシンごとの設定にのみ影響する必要があります。

レジストリ値を次のように設定します。

HKEY_LOCAL_MACHINE
   Software
      Clients
         ClientTypeName
            (Default) = CanonicalName

Note

次の情報は、Windows XP にのみ適用されます。

上記のように、コンピューターレベルの既定値 HKEY_LOCAL_MACHINE の登録に成功した場合、アプリケーションは、次のサブキーの下にある Default エントリに割り当てられた値を削除します。

HKEY_CURRENT_USER
   SOFTWARE
      Clients
         ClientTypeName

上記のように、コンピューターレベルの既定値の HKEY_LOCAL_MACHINE での登録が失敗した場合 (通常、ユーザーにサブキーへの書き込みアクセス許可がないため)、アプリケーションは次の値を設定します。

HKEY_CURRENT_USER
   SOFTWARE
      Clients
         ClientTypeName
            (Default) = CanonicalName

これにより、現在のユーザーに対してのみ正規名が登録されます。すべてのユーザーに対して登録されるわけではありません。

レジストリキーを更新した後、プログラムは、既定のクライアントが変更されたことをオペレーティングシステムに通知するために、null で終わる文字列 "Software\Clients\ClientTypeName" を指す wParam = 0 と lParam を使用して、WM_SETTINGCHANGE メッセージをブロードキャストします。

メールクライアントの登録

メールクライアントの場合、mailto プロトコルを使用する URL にサービスを提供するには、プログラムで HKEY_CLASSES_ROOT\mailto キーの下に設定を登録する必要があります。これらの設定を反映する値とキーを次のキーの下に設定します。

HKEY_LOCAL_MACHINE
   Software
      Clients
         Mail
            CanonicalName
               Protocols
                  mailto

このレジストリ階層は、HKEY_CLASSES_ROOT\mailto で見つかった既存の mailto レジストリと置き換えます。階層は同じままであり、場所のみが変更されています。この階層の形式については、MSDN の「非同期プラグ可能プロトコルの概要とチュートリアル」を参照してください。通常、mailto プロトコルは非同期プロトコルではなくプログラムに登録されます。この場合、「アプリケーションを URI スキームに登録する」に関するドキュメントが適用されます。

次の例は、プログラムに登録された mailto ハンドラーの登録の mailto セクションを示しています。

HKEY_LOCAL_MACHINE
   Software
      Clients
         Mail
            CanonicalName
               Protocols
                  mailto
                     (Default) = URL:MailTo Protocol
                     EditFlags = 02 00 00 00
                     URL Protocol
                     DefaultIcon
                        (Default) = %FilePath%,IconIndex
                     shell
                        open
                           command
                              (Default) = command line

EditFlags レジストリ値は、「ファイルの種類の属性の定義」セクションの「ファイルの種類」に記載されています。

完全なサンプルの登録

さまざまなクライアントの種類の完全な登録要件を示す例を次に示します。

サンプルブラウザー
サンプルメールブラウザー
サンプルメディアプレーヤー
サンプルインスタントメッセンジャープログラム
サンプル Virtual Machine for Java

サンプルブラウザー

HKEY_LOCAL_MACHINE
   Software
      Clients
         StartMenuInternet
            LITVIEW.EXE
               (Default) = Lit View
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
                  IconsVisible = 1
                  shell
                     open
                        command
                           (Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /homepage

サンプルメールブラウザー

HKEY_LOCAL_MACHINE
   Software
      Clients
         Mail
            Lit View
               (Default) = Lit View
               DLLPath = @C:\Program Files\LItwareInc\LitwareMAPI.dll
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
                  IconsVisible = 1
               shell
                  open
                     command
                        (Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /inbox
               protocols
                  mailto
                     (Default) = URL:MailTo Protocol
                     EditFlags = 02 00 00 00
                     URL Protocol
                     DefaultIcon
                        (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
                     shell
                        open
                           command
                              (Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /mailto:%1

サンプルメディアプレーヤー

HKEY_LOCAL_MACHINE
   Software
      Clients
         Media
            Lit View
               (Default) = Lit View
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
                  IconsVisible = 1

サンプルインスタントメッセンジャープログラム

HKEY_LOCAL_MACHINE
   Software
      Clients
         IM
            Lit View
               (Default) = Lit View
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
                  IconsVisible = 1

サンプル Virtual Machine for Java

HKEY_LOCAL_MACHINE
   Software
      Clients
         JavaVM
            Lit View
               (Default) = Lit View
               LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
               DefaultIcon
                  (Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
               InstallInfo
                  ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
                  HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
                  ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
                  IconsVisible = 1

例として登場する企業、組織、製品、ドメイン名、電子メールアドレス、ロゴ、人物、場所、およびイベントはすべて架空のものです。これらは、実在する会社、組織、製品、ドメイン名、電子メールアドレス、ロゴ、人物、場所、および出来事とはまったく関係ありません。

既定のプログラム
Windows の [スタート] メニューでインターネットブラウザーまたは電子メールクライアントを登録する方法
Internet Explorer クライアントレジストリのレイアウト (「クライアントレジストリキーの定義」セクションを参照)
非同期プラグ可能プロトコルの概要とチュートリアル
アプリケーションを URI スキームに登録する

クライアントの種類にプログラムを登録する

すべてのクライアントの種類の共通登録要素

正規名の選択

プログラムの表示名の登録

プログラムのアイコンの登録

オープン動詞の登録

インストール情報の登録

再インストールコマンド

[アイコンの非表示] コマンド

SPAD の代替非表示アイコンメソッド

[アイコンの表示] コマンド

グループプログラムの構成

ブラウザー登録の例

特定のクライアントの種類の登録要素

スタートメニューの登録

メールクライアントの登録

完全なサンプルの登録

サンプルブラウザー

サンプルメールブラウザー

サンプルメディアプレーヤー

サンプルインスタントメッセンジャープログラム

サンプル Virtual Machine for Java

フィードバック

フィードバック

その他のリソース

クライアントの種類にプログラムを登録する

すべてのクライアントの種類の共通登録要素

正規名の選択

プログラムの表示名の登録

プログラムのアイコンの登録

オープン動詞の登録

インストール情報の登録

再インストール コマンド

[アイコンの非表示] コマンド

SPAD の代替非表示アイコン メソッド

[アイコンの表示] コマンド

グループ プログラムの構成

ブラウザー登録の例

特定のクライアントの種類の登録要素

スタート メニューの登録

メール クライアントの登録

完全なサンプルの登録

サンプル ブラウザー

サンプル メール ブラウザー

サンプル メディア プレーヤー

サンプル インスタント メッセンジャー プログラム

サンプル Virtual Machine for Java

関連トピック

フィードバック

フィードバック

その他のリソース

再インストールコマンド

SPAD の代替非表示アイコンメソッド

グループプログラムの構成

スタートメニューの登録

メールクライアントの登録

サンプルブラウザー

サンプルメールブラウザー

サンプルメディアプレーヤー

サンプルインスタントメッセンジャープログラム