Udostępnij przez


Identyfikatory kontenerów dla urządzeń DPWS

Począwszy od systemu Windows 7, urządzenie obsługujące rozszerzenia PnP (PnP-X) i profil urządzenia dla usług sieci Web (DPWS) może określić identyfikator kontenera, uwzględniając element ContainerId XML w dokumencie metadanych urządzenia. Aby uzyskać więcej informacji na temat programu DPWS i dokumentu metadanych urządzenia DPWS, zapoznaj się ze specyfikacją programu DPWS.

Uwaga / Notatka

Począwszy od systemu Windows 10, system ignoruje identyfikator kontenera dostarczony przez urządzenie i zamiast tego generuje go samodzielnie. Robi to za pomocą identyfikatora GUID z adresu odniesienia punktu końcowego (EPR) urządzenia lub skrótu SHA-1 adresu EPR urządzenia (jeśli nie jest to identyfikator GUID).

Element XML ContainerId jest zadeklarowany w następujący sposób:

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

Typ elementu ContainerId XML jest ciągiem, dla którego wartość jest globalnie unikatowym identyfikatorem (GUID) sformatowanym. Ten ciąg jest sformatowany jako {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Poniżej przedstawiono przykład elementu XML ContainerId .

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

Element <XML ContainerId> musi znajdować się w sekcji <ThisDevice> wymiany metadanych urządzenia w komunikacie Simple Object Access Protocol (SOAP). W poniższym przykładzie pokazano prawidłowe rozmieszczenie <elementu ContainerId> w komunikacie wymiany metadanych.

Uwaga / Notatka

Nie jest to kompletny dokument wymiany metadanych programu DPWS. Aby uzyskać więcej informacji na temat programu DPWS, zapoznaj się ze specyfikacją programu DPWS.

<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>

Jeśli dokument metadanych urządzenia DPWS nie zawiera elementu XML ContainerId , menedżer Plug and Play (PnP) używa wartości adresu odniesienia punktu końcowego urządzenia jako identyfikatora kontenera.