标识提供程序

  • 项目

清单可以标识一个或多个提供程序。 若要标识提供程序，请使用 provider 元素。 必须指定 名称、 guid、 resourceFileName、 messageFileName 和 symbol 属性。 如果本地化清单，还应指定 消息 属性，使用者使用该属性来显示提供程序的名称。 如果未指定 消息 属性，则使用者将使用 name 属性的值。

最多可以在清单中标识 16 个提供程序。 如果要标识超过 16 个提供程序，则必须包含清单的 messageTable 部分，第 17 个提供程序和上提供程序必须使用该部分为其定义的消息字符串分配资源值 - 消息表不得包含提供程序 1 到 16 定义的任何消息字符串。

以下示例演示如何使用 provider 元素来标识提供程序。

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    >

    <instrumentation>
        <events>
            <provider name="Microsoft-Windows-SampleProvider" 
                guid="{1db28f2e-8f80-4027-8c5a-a11f7f10f62d}" 
                symbol="PROVIDER_GUID" 
                resourceFileName="<path to the exe or dll that contains the metadata resources>" 
                messageFileName="<path to the exe or dll that contains the string resources>"
                message="$(string.Provider.Name)">

                . . .

            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources culture="en-US">
            <stringTable>
                <string id="Provider.Name" value="Microsoft-Windows-SampleProvider"/>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>