Container-ID's voor DPWS-apparaten

Vanaf Windows 7 kan een apparaat dat PnP-extensies (PnP-X) en Device Profile for Web Services (DPWS) ondersteunt, een container-id opgeven door het Xml-element ContainerId op te nemen in het metagegevensdocument van het apparaat. Raadpleeg de DPWS-specificatie voor meer informatie over DPWS en het document met metagegevens van DPWS-apparaten.

Opmerking

Vanaf Windows 10 negeert het systeem de container-id die door een apparaat wordt geleverd en wordt er in plaats daarvan zelf een gegenereerd. Dit gebeurt met behulp van de GUID van het eindpuntverwijzingsadres (EPR) van het apparaat of een SHA-1 hash van de EPR van het apparaat (als dat geen GUID is).

Het XML-element ContainerId wordt als volgt gedeclareerd:

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

Het XML-elementtype ContainerId is een tekenreeks waarbij de waarde is geformatteerd als een wereldwijd unieke identificatie (GUID). Deze tekenreeks is opgemaakt als {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx}.

Hier volgt een voorbeeld van een ContainerId XML-element.

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

Het <ContainerId> XML-element moet zich in de <ThisDevice>-sectie van het SOAP-bericht (Simple Object Access Protocol) van het apparaat bevinden. In het volgende voorbeeld ziet u de juiste plaatsing van het ContainerId-element> in een bericht over het <uitwisselen van metagegevens.

Opmerking

Dit is geen volledig DPWS-document voor het uitwisselen van metagegevens. Raadpleeg de DPWS-specificatie voor meer informatie over 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>

Als het document met metagegevens van DPWS-apparaten het XML-element ContainerId niet bevat, gebruikt de PnP-manager (Plug and Play) de waarde van het eindpuntreferentieadres van het apparaat als container-id.

  • Last updated on