Identifiants de conteneur pour les appareils DPWS

À 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) peuvent 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 de l’appareil DPWS, reportez-vous à la spécification DPWS.

Remarque

À compter de Windows 10, le système ignore l’ID de conteneur fourni par un appareil et génère plutôt un seul. Pour ce faire, le système utilise le GUID de l'adresse de référence de 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 mise en forme comme {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 de l’appareil. L’exemple suivant montre le positionnement correct de l’élément <ContainerId> dans un message d’échange de métadonnées.

Remarque

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 de l’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 de point de terminaison de l’appareil comme ID de conteneur.

  • Last updated on