desktop7:ApprovedShellExtension

  • [アーティクル]

インストール時に、承認されたシェル拡張機能の一覧にシェル拡張機能を追加するように指定します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <desktop7:Extension>

                        <desktop7:ApprovedShellExtension>

構文

<desktop7:ApprovedShellExtension
  Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Clsid = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' />

属性と要素

属性

属性 説明 データ型 必須 既定値
名前 シェル拡張機能のわかりやすい名前。 この値は、実際にはシステムによって直接使用されるわけではありませんが、レジストリ内のエントリを読み取りやすくなります。 長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白文字以外の文字が含まれます。 Yes
Clsid シェル拡張機能を実装する COM クラスの Clsid。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx という形式の GUID。 Yes

子要素

なし。

親要素

親要素 説明
拡張子 アプリケーションの機能拡張ポイントを定義します。

注釈

重要

承認されたシェル拡張機能を登録するには、「 シェル拡張機能ハンドラーの登録」に示されているように、インストーラーに管理アクセス許可が必要です。

MSIX アプリにはカスタム インストーラーがないため、ユーザーが管理者として手動で実行する方法はありません。 代わりに、 desktop7:ApprovedShellExtension 要素を使用する MSIX ベースのアプリでは、 desktop7:Scope manifest 属性を マシン の値に設定する必要があります (これにより、インストール中に昇格するようにユーザーに求められます)。 desktop:Extension 要素に desktop7:Scope 属性を設定します。

同様に、 desktop7:Scope 属性を マシンに設定するには、アプリのパッケージでカスタム機能 <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>を宣言する必要があります。 そのカスタム機能は、限られたアプリのセットにのみ付与されます。

シェル拡張機能は、パッケージ化された COM を介して公開されるマニフェストの COM クラスと組み合わせて使用されます (windows.comServer「com:ComServer」を参照)。 その COM クラスは、 シェル拡張機能ハンドラー ( DesktopPropertyHandler、 ThumbnailHandler など) として使用されます。 この情報は、アプリ パッケージ マニフェストで宣言できるすべてのシェル拡張機能に適用されます。

シェル拡張機能ハンドラーの登録に関するページで説明したように、desktop7:ApprovedShellExtension 要素を含めるか含まないかの影響は、マシンの管理者がキー EnforceShellExtensionSecurity をオンにしたときにシェル拡張機能がオフになるかどうかです。

必要条件

Item 値
名前空間 http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
Minimum OS Version Windows 10 (ビルド 19645)