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.

Return code Description
WS_E_INVALID_FORMAT
The input data was not in the expected format or did not have the expected value.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header webservices.h
Library WebServices.lib
DLL WebServices.dll