WsReadQualifiedName function

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 WINAPI  WsReadQualifiedName(
  _In_     WS_XML_READER* reader,
  _In_     WS_HEAP*       heap,
           WS_XML_STRING* prefix,
  _Out_    WS_XML_STRING* *localName,
           WS_XML_STRING* ns,
  _In_opt_ WS_ERROR*      error
);

Parameters

reader [in]

The reader which should read the qualified name.

heap [in]

The heap on which the resulting strings should be allocated.

prefix

The prefix of the qualified name is returned here.

localName [out]

The localName of the qualified name is returned here.

ns

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

error [in, optional]

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