Container-IDs für DPWS-Geräte

Ab Windows 7 kann ein Gerät, das PnP-Erweiterungen (PnP-X) und Geräteprofil für Webdienste (DPWS) unterstützt, eine Container-ID angeben, indem das ContainerId XML-Element in das Dokument mit den Gerätemetadaten eingeschlossen wird. Weitere Informationen zu DPWS und dem Dokument zu DPWS-Gerätemetadaten finden Sie in der DPWS-Spezifikation.

Hinweis

Ab Windows 10 ignoriert das System die von einem Gerät bereitgestellte Container-ID und generiert stattdessen eine selbst. Dazu wird entweder die GUID aus der Endpunktreferenzadresse (Endpoint Reference Address, EPR) des Geräts oder ein SHA-1-Hash der EPR des Geräts (sofern keine GUID) verwendet.

Das XML-Element ContainerId wird wie folgt deklariert:

<df:ContainerId xmlns:df="">
  xs:string
</df:ContainerId>

Der XML-Elementtyp ContainerId ist eine Zeichenfolge, für die der Wert eine GUID (Globally Unique Identifier) formatiert ist. Diese Zeichenfolge ist als {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx} formatiert.

Im Folgenden finden Sie ein Beispiel für ein ContainerId-XML-Element.

<df:ContainerId xmlns:df="">
  {101392d0-5e91-11dd-ad8b-0800200c9a66}
</df:ContainerId>

Das <XML-Element ContainerId> muss sich im <Abschnitt ThisDevice> der SOAP-Nachricht (Simple Object Access Protocol) des Gerätemetadatenaustauschs befinden. Das folgende Beispiel zeigt die richtige Platzierung des <ContainerId-Elements> in einer Metadatenaustauschnachricht.

Hinweis

Dies ist kein vollständiges DPWS-Metadatenaustauschdokument. Weitere Informationen zu DPWS finden Sie in der DPWS-Spezifikation.

<soap:Envelope
    xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
    xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
    xmlns:wsdisco="http://schemas.xmlsoap.org/ws/2005/04/discovery"
    xmlns:wsx="http://schemas.xmlsoap.org/ws/2004/09/mex"
    xmlns:wsd="http://schemas.xmlsoap.org/ws/2006/02/devprof"
    xmlns:df="http://schemas.microsoft.com/windows/2008/09/devicefoundation">

    <soap:Header>
        <!-- Place SOAP header information here.-->
    </soap:Header>

    <soap:Body>
        <wsx:Metadata>

           <wsx:MetadataSection
                Dialect="http://schemas.xmlsoap.org/ws/2005/05/devprof/ThisModel">
                <wsd:ThisDevice>
                    <!-- Place ThisDevice metadata here.-->
                    <df:ContainerId>
                        <!--- Place the ContainerID GUID here.--->
                        {101392d0-5e91-11dd-ad8b-0800200c9a66}
                    </df:ContainerId>
                </wsd:ThisDevice>
            </wsx:MetadataSection>

        </wsx:Metadata>
    </soap:Body>
</soap:Envelope>

Wenn das DPWS-Gerätemetadatendokument das XML-Element ContainerId nicht enthält, verwendet der Plug & Play-Manager (PnP) den Wert der Endpunktverweisadresse des Geräts als Container-ID.