WsWriteXmlnsAttribute-Funktion (webservices.h)

  • Artikel

Schreibt ein Xmlns-Attribut in das aktuelle Element. WsWriteStartElement muss aufgerufen werden, bevor ein Attribut geschrieben werden kann. Wenn die Anzahl der Attribute die maximale Anzahl von Attributen überschreitet, die für den Writer zulässig sind, gibt die Funktion WS_E_QUOTA_EXCEEDED zurück. (Siehe Rückgabewerte für Windows-Webdienste.)

Syntax

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER-Objekt , in das das Xmlns-Attribut geschrieben wird. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

[in, optional] prefix

Ein WS_XML_STRING Zeiger auf das Präfix, das für das Startelement verwendet werden soll. Wenn der Wert, auf den durch diesen Parameter verwiesen wird , NULL ist, wählt der Writer ein Attribut aus.

Gibt das Präfix an, das für das xmlns-Attribut verwendet werden soll.

[in] ns

Ein WS_XML_STRING Zeiger auf den Namespace, der an das Präfix gebunden werden soll.

[in] singleQuote

Bestimmt, ob ein einzelnes oder ein doppeltes Anführungszeichen für den Attributwert verwendet werden soll.

Hinweis Wenn WS_XML_WRITER_BINARY_ENCODING festgelegt ist, wird das Anführungszeichen nicht beibehalten, und dieser Parameter hat keine Auswirkung.

 

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
WS_E_INVALID_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_INVALID_FORMAT
 Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.

Hinweise

Die folgenden Bedingungen gelten:

  • Wenn ein leeres Präfix angegeben wird, wird der Standardnamespace zugewiesen.
  • Wenn ein NULL-Präfix angegeben wird, wählt der Writer das entsprechende Präfix für den Namespace aus.
  • Wenn das Xmlns-Attribut redundant ist, kann es nicht geschrieben werden.
  • Wenn ein nicht leeres Präfix mit einem leeren Namespace angegeben wird , wird WS_E_INVALID_FORMAT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll