WsReadQualifiedName function (webservices.h)

Reads a qualified name and separates it into its prefix, localName and namespace based on the current namespace scope of the XML_READER. If the ns parameter is specified, then the namespace that the prefix is bound to will be returned, or WS_E_INVALID_FORMAT will be returned. (See Windows Web Services Return Values.) The strings are placed in the specified heap.

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
);

Parameters

[in] reader

The reader which should read the qualified name.

[in] heap

The heap on which the resulting strings should be allocated.

prefix

The prefix of the qualified name is returned here.

[out] localName

The localName of the qualified name is returned here.

ns

The namespace to which the qualified name is bound is returned here.

[in, optional] error

If the localName is missing the function will return WS_E_INVALID_FORMAT.
If the ns parameter is specified, but the prefix is not bound to a namespace, WS_E_INVALID_FORMAT will be returned.

Return value

This function can return one of these values.

Requirements