Identificadores de contenedor para dispositivos DPWS

A partir de Windows 7, un dispositivo que admite extensiones PnP (PnP-X) y Perfil de dispositivo para servicios web (DPWS) puede especificar un identificador de contenedor incluyendo el elemento XML ContainerId en el documento de metadatos del dispositivo. Para obtener más información sobre DPWS y el documento de metadatos del dispositivo DPWS, consulte la especificación de DPWS.

Nota:

A partir de Windows 10, el sistema omite el identificador de contenedor proporcionado por un dispositivo y, en su lugar, genera uno por sí mismo. Esto se hace mediante el GUID de la dirección de referencia del punto de conexión (EPR) del dispositivo o un hash SHA-1 del EPR del dispositivo (si no es un GUID).

El elemento XML ContainerId se declara de la siguiente manera:

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

El tipo de elemento XML ContainerId es una cadena, para la que el valor es un identificador único global (GUID) con formato. Esta cadena tiene el formato {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

A continuación se muestra un ejemplo de un elemento XML ContainerId .

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

El elemento XML <ContainerId> debe estar en la sección <ThisDevice> del mensaje SOAP (Protocolo de Acceso a Objetos Sencillo) del intercambio de metadatos del dispositivo. En el ejemplo siguiente se muestra la ubicación correcta del <elemento ContainerId> en un mensaje de intercambio de metadatos.

Nota:

No se trata de un documento completo de intercambio de metadatos de DPWS. Para obtener más información sobre DPWS, consulte la especificación 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 el documento de metadatos del dispositivo DPWS no incluye el elemento XML ContainerId , el administrador de Plug and Play (PnP) usa el valor de la dirección de referencia del punto de conexión del dispositivo como identificador de contenedor.

  • Last updated on