Delen via

WsUtil Compiler-hulpprogramma

  • Artikel

Het compilerprogramma voor Windows Web Services, WsUtil.exe, ondersteunt het servicemodel en serialisatie van gegevenstypen. Het verwerkt WSDL-, XML-schema- en beleidsdocumenten en genereert C-headers en bronbestanden. Dit hulpprogramma is vergelijkbaar met het WSDL-compilerprogramma voor beheerde code, maar is in plaats daarvan gericht op systeemeigen code.

Ter ondersteuning van het servicemodelgenereert WsUtil.exe headers die moeten worden gebruikt voor zowel client als service. Het genereert indien nodig C-proxybestand voor de client en C stub-bestanden voor de servicezijde.

Ter ondersteuning van serialisatiegenereert de compiler headers voor elementbeschrijvingen voor globale elementdefinities en alle typedefinitiegegevens in de proxybestanden die worden gebruikt door de serialisatie-engine.

Zie de volgende onderwerpen voor opdrachtregelopties voor het verwerken van WSDL-bestanden, XML-schemabestanden en webservicebeleidsbestanden:

Veiligheid

Wanneer u WsUtil gebruikt, moet u rekening houden met de volgende problemen en de juiste voorzorgsmaatregelen observeren:

  • Wsutil haalt geen XML-metagegevens op via het netwerk en wsutil lost import- en/of include-instructies niet op in de invoermetagegevensbestanden. Wsutil wordt geopend en leest wsdl-, xsd- en beleidsbestanden. XML-metagegevens zijn niet bestand tegen manipulatie. Zorg ervoor dat u alleen wsdl-, xsd- en beleidsbestanden gebruikt die afkomstig zijn van de vertrouwde bron en ervoor zorgen dat u de bestanden beveiligt tegen manipulatie voor en na het gebruik ervan. Controleer zorgvuldig de inhoud van de invoerbestanden en controleer of de inhoud van bestanden veilig is voor gebruik in de toepassing. Wsutil.exe voert geen verificatie uit van de echtheid van de metagegevensbestanden.
  • Wsutil genereert header- en stubbestanden, die niet bestand zijn tegen manipulatie. U moet de juiste toegangsrechten op niveau instellen voor bronbestanden die door wsutil.exe worden gegenereerd om niet-geverifieerde toegang tot deze bestanden te voorkomen. Wsutil maakt gebruik van System.IO.StreamWriter om de uitvoerbestanden te maken.
  • Gebruikers moeten zich ervan bewust zijn dat Wsutil hun lokale bestanden kan overschrijven en ze moeten voorzichtig zijn met het opgeven van veilige bestandsnamen en mappen voor uitvoerbestanden met behulp van de schakeloptie /out.
  • Wsutil of wsutilhelper.dll geladen in wsutil.exe, kan onverwacht worden beëindigd of grote hoeveelheden systeembronnen verbruiken wanneer ze worden aangevallen of bij het verwerken van een zeer grote hoeveelheid invoermetagegevens. Het hulpprogramma is ontworpen om te worden gebruikt tijdens de ontwikkeling alleen dit hulpprogramma moet worden gebruikt als een hulpprogramma voor ontwikkelingstijd. Het is mogelijk niet veilig voor gebruik in de middelste laag om beleidsinformatie te verwerken.
  • Wsutilhelper.dll helper-DLL wordt geladen in beheerde wsutil.exe om beleidsinformatie te verwerken. De gebruiker moet ervoor zorgen dat er geen schadelijk binair bestand met dezelfde bestandsnaam bestaat in het binaire pad. Op dezelfde manier moet de gebruiker ervoor zorgen dat in de build-omgeving het binaire pad correct is ingesteld dat er geen kwaadwillend binair bestand met dezelfde "wsutil.exe" naam bestaat.
  • Wsutil genereert SAL-aantekening voor bewerkingen en structuurvelden, indien mogelijk. Gebruiker van gegenereerde wsutil-bestanden moet voldoen aan de vereiste die is opgegeven via SAL-aantekeningen.

Overzicht van servicemodellagen

serialisatie

Web Service Compiler-hulpprogramma

WSDL-ondersteuning

Schema-ondersteuning

beleidsondersteuning