WsReadQualifiedName-Funktion (webservices.h)

  • Artikel

Liest einen qualifizierten Namen und trennt ihn basierend auf dem aktuellen Namespacebereich des XML_READER in sein Präfix, localName und Namespace. Wenn der ns-Parameter angegeben wird, wird der Namespace zurückgegeben, an den das Präfix gebunden ist, oder WS_E_INVALID_FORMAT wird zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.) Die Zeichenfolgen werden im angegebenen Heap platziert.

Syntax

HRESULT WsReadQualifiedName(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_STRING *prefix,
  [out]          WS_XML_STRING *localName,
                 WS_XML_STRING *ns,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Der Leser, der den qualifizierten Namen lesen soll.

[in] heap

Der Heap, auf dem die resultierenden Zeichenfolgen zugeordnet werden sollen.

prefix

Das Präfix des qualifizierten Namens wird hier zurückgegeben.

[out] localName

Der localName des qualifizierten Namens wird hier zurückgegeben.

ns

Der Namespace, an den der qualifizierte Name gebunden ist, wird hier zurückgegeben.

[in, optional] error

Wenn localName fehlt, gibt die Funktion WS_E_INVALID_FORMAT zurück.
Wenn der ns-Parameter angegeben ist, das Präfix aber nicht an einen Namespace gebunden ist, wird WS_E_INVALID_FORMAT zurückgegeben.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.

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