Compartir a través de


Herramienta del compilador WsUtil

La herramienta del compilador de servicios web de Windows, WsUtil.exe, admite el modelo de servicio y la serialización de tipos de datos. Procesa los documentos WSDL, esquema XML y directivas, y genera encabezados C y archivos de origen. Esta herramienta es similar a la herramienta del compilador WSDL para código administrado, pero está dirigida a código nativo en su lugar.

Para admitir el modelo de servicio, WsUtil.exe genera encabezados que se usarán para el cliente y el servicio. Genera un archivo de proxy C para el lado cliente y archivos de código auxiliar de C para el lado del servicio, según sea necesario.

Para admitir la serialización, el compilador genera encabezados para descripciones de elementos para definiciones de elementos globales y toda la información de definición de tipo en los archivos proxy consumidos por el motor de serialización.

Para ver las opciones de línea de comandos para procesar archivos WSDL, archivos de esquema XML y archivos de directiva de servicio web, consulte los temas siguientes:

Seguridad

Cuando use WsUtil, tenga en cuenta los siguientes problemas y observe las precauciones adecuadas:

  • Wsutil no recupera metadatos XML a través de la red y wsutil no resuelve instrucciones import ni include en los archivos de metadatos de entrada. Wsutil abre y lee archivos de directiva, xsd y wsdl. Los metadatos XML no son resistentes a alteraciones. Asegúrese de que solo se usan archivos wsdl, xsd y policy de origen de confianza y asegúrese de proteger los archivos de manipulación antes y después de usarlos. Revise detenidamente el contenido de los archivos de entrada y compruebe que el contenido de los archivos es seguro para su uso en la aplicación. Wsutil.exe no realiza ninguna comprobación de la autenticidad de los archivos de metadatos.
  • Wsutil genera archivos de encabezado y código auxiliar, que no son resistentes a alteraciones. Debe establecer los derechos de acceso de nivel correctos en los archivos de origen generados por wsutil.exe para evitar el acceso no autenticado a esos archivos. Wsutil usa System.IO.StreamWriter para crear los archivos de salida.
  • Los usuarios deben tener en cuenta que Wsutil puede sobrescribir sus archivos locales y deben tener cuidado de especificar nombres de archivo seguros y directorios para archivos de salida mediante el modificador /out.
  • Wsutil o wsutilhelper.dll cargados en wsutil.exe, puede terminar inesperadamente o consumir una gran cantidad de recursos del sistema cuando se está atacando o procesando una cantidad muy grande de metadatos de entrada. La herramienta está diseñada para usarse durante el tiempo de desarrollo solo esta herramienta debe usarse como herramienta de tiempo de desarrollo. Puede que no sea seguro para su uso en el nivel intermedio para procesar la información de la directiva.
  • Wsutilhelper.dll DLL del asistente se carga en wsutil.exe administrados para procesar la información de la directiva. El usuario debe asegurarse de que no existe ningún archivo binario malintencionado con el mismo nombre de archivo en la ruta de acceso binaria. Del mismo modo, el usuario debe asegurarse de que en el entorno de compilación, la ruta de acceso binaria está configurada correctamente que no existe ningún binario malintencionado con el mismo nombre de "wsutil.exe".
  • Wsutil genera anotaciones SAL para los campos de operaciones y estructura siempre que sea posible. El usuario de los archivos generados por wsutil debe seguir el requisito especificado a través de la anotación SAL.

Información general sobre la capa de modelo de servicio

Serialización

Herramienta del compilador de servicios web

Compatibilidad con WSDL

Compatibilidad con esquemas

Compatibilidad con directivas