com3:ServiceServer

  • [アーティクル]

対応する desktop6:Service 要素で宣言されている Windows サービスでホストされている COM サーバー (1 つ以上のクラス登録を含む) を登録します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <com2:Extension>

                        <com2:ComServer>

                             <com3:ServiceServer>

構文

<com3:ServiceServer
    ServiceName = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'An optional [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.' >

  <!-- Child elements -->
  com3:Class{1,10000}

</com3ServiceServer>

キー

{} 特定の出現範囲

属性と要素

属性

属性 説明 データ型 必須 既定値
ServiceName COM サーバーをホストする Windows サービスの名前。 このサービス名は、パッケージ マニフェスト内の同じアプリケーション レベルの Extensions 要素内の対応する desktop6:Service 要素の名前と一致する必要があります。 長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白文字以外の文字が含まれます。 Yes
引数 サービスのコマンド ライン パラメーター。 長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白文字以外の文字が含まれます。 いいえ
DisplayName 既定の AppID キー値に対応するローカライズ可能な文字列。 1 ~ 256 文字の長さの値を持つ省略可能な文字列。 いいえ
LaunchAndActivationPermission AppID キーの LaunchPermission 値に対応する SDDL 文字列 。 省略可能な SDDL 文字列 値。 いいえ

子要素

子要素 説明
com3:Class COM サーバーのクラス登録を定義します。

親要素

親要素 説明
com2:ComServer windows.comServer 型のパッケージ拡張ポイントを宣言します。 comServer 拡張機能には、ServiceServer、ExeServer、SurrogateServer、ProgId、または TreatAsClass という種類の登録が含まれる場合があります。

注釈

ServiceServer には、1 つ以上のクラス登録を含めることができます。 LocalService キーが一致し、同じ AppID (または AppID がない場合) がある場合は、異なる Applications/Application マニフェスト要素で登録する必要がない限り、複数のクラス登録で ServiceServer を共有する必要があります。

例

<?xml version="1.0" encoding="utf-8"?>
<Package IgnorableNamespaces="uap com com2 com3 desktop6"
         xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
         xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
         xmlns:com2="http://schemas.microsoft.com/appx/manifest/com/windows10/2"
         xmlns:com3="http://schemas.microsoft.com/appx/manifest/com/windows10/3">
...
    <Applications>
        <Application ...>
            <Extensions>
                <desktop6:Extension Category="windows.service" Executable="ContosoPackagedService.exe" EntryPoint="packagedServiceComServer.service">
                    <desktop6:Service Name="examplePackagedServiceComServer" StartupType="manual" StartAccount="localService" /> 
                </desktop6:Extension>
                <com2:Extension Category="windows.comServer">
                    <com2:ComServer>
                        <com3:ServiceServer ServiceName="examplePackagedServiceComServer" DisplayName="ServicePackage public service server" 
                            LaunchAndActivationPermission="O:SYG:SYD:(A;;11;;;WD)(A;;11;;;RC)(A;;11;;;AC)(A;;11;;;AN)S:P(ML;;NX;;;S-1-16-0)">
                            <com3:Class Id="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5" DisplayName="CLSID_ContosoPublicServiceNoHandler"/>
                        </com3:ServiceServer>
                        <com3:TreatAsClass Id="2DAA3C97-F340-4C0E-B23C-92338974C5E9" DisplayName="CLSID_ContosoPublicServiceTreatAs" 
                            TreatAs="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler" Clsid="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler.1" CurrentVersion="ContosoPublicServiceNoHandler"/>
                    </com2:ComServer>
                </com2:Extension>
            </Extensions>
        </Application>
    </Applications>
</Package>

必要条件

Item 値
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/3
Minimum OS Version Windows 10 バージョン 2004 (ビルド 19041)