Partager via

ID de conteneur pour les appareils DPWS

  • Article

À compter de Windows 7, un appareil qui prend en charge les extensions PnP (PnP-X) et le profil d’appareil pour les services Web (DPWS) peut spécifier un ID de conteneur en incluant l’élément XML ContainerId dans le document de métadonnées de l’appareil. Pour plus d’informations sur DPWS et le document de métadonnées d’appareil DPWS, reportez-vous à la spécification DPWS.

Notes

À compter de Windows 10, le système ignore l’ID de conteneur fourni par un appareil et en génère un seul. Pour ce faire, il utilise le GUID de l’adresse de référence du point de terminaison (EPR) de l’appareil ou un hachage SHA-1 de l’EPR de l’appareil (si ce n’est pas un GUID).

L’élément XML ContainerId est déclaré comme suit :

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

Le type d’élément XML ContainerId est une chaîne pour laquelle la valeur est un identificateur global unique (GUID) mis en forme. Cette chaîne est au format {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Voici un exemple d’élément XML ContainerId .

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

L’élément <XML ContainerId> doit se trouver dans la <section ThisDevice> du message SOAP (Simple Object Access Protocol) d’échange de métadonnées d’appareil. L’exemple suivant montre l’emplacement correct de l’élément <ContainerId> dans un message d’échange de métadonnées.

Notes

Il ne s’agit pas d’un document complet d’échange de métadonnées DPWS. Pour plus d’informations sur DPWS, reportez-vous à la spécification 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>

Si le document de métadonnées d’appareil DPWS n’inclut pas l’élément XML ContainerId, le gestionnaire Plug-and-Play (PnP) utilise la valeur de l’adresse de référence du point de terminaison de l’appareil comme ID de conteneur.