Windows Dev Center

Expand Minimize

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.

Return codeDescription
WS_E_INVALID_FORMAT

The input data was not in the expected format or did not have the expected value.

 

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft