Función WsGetNamespaceFromPrefix (webservices.h)

  • Artículo

Esta función devuelve un espacio de nombres del prefijo al que está enlazado.

Si el valor del parámetro necesario se establece en TRUE y el prefijo no está enlazado a ningún espacio de nombres, se devolverá una excepción de WS_E_INVALID_FORMAT . (Consulte Valores devueltos de servicios web de Windows). Si el parámetro necesario es FALSE y el prefijo no está enlazado a ningún espacio de nombres, el parámetro ns será NULL y la función devolverá S_FALSE.

Sintaxis

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Parámetros

[in] reader

Puntero al lector para el que se debe buscar el prefijo.

[in] prefix

Puntero al prefijo que se va a buscar.

[in] required

El valor de este parámetro booleano determina si se debe devolver o no un error si no se encuentra un espacio de nombres coincidente.

ns

Referencia a un espacio de nombres al que se enlaza el prefijo si se ejecuta correctamente. El valor devuelto solo es válido hasta que el escritor avanza.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.

Comentarios

Para el prefijo "xml", devolverá el espacio de nombres "http://www.w3.org/XML/1998/namespace".

Para el prefijo "xmlns", devolverá el espacio de nombres "http://www.w3.org/2000/xmlns/".

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll