WsReadQualifiedName-Funktion (webservices.h)

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.

Anforderungen