Función WsGetPrefixFromNamespace (webservices.h)

  • Artículo

Esta función devuelve el prefijo al que está enlazado un espacio de nombres. Puede haber más de un prefijo en el ámbito y esta función puede devolver cualquiera de ellos.

Nota En ningún caso, un autor de la llamada debe depender o esperar que se devuelva un prefijo determinado cuando haya más de un prefijo que se pueda devolver.
 

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

Si se llama a WsWriteStartElement , pero el elemento no confirma los espacios de nombres y prefijos a los que hace referencia el elemento y los atributos del elemento no están disponibles para esta función.

Sintaxis

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

Parámetros

[in] writer

Puntero a un escritor con el espacio de nombres que se va a buscar. Debe ser un objeto WS_XML_WRITER válido devuelto por WsCreateWriter y no puede ser NULL.

[in] ns

Espacio de nombres que se va a buscar.

[in] required

Indica si se debe devolver o no un error si no se encuentra un prefijo coincidente.

prefix

Referencia a un prefijo enlazado al espacio de nombres o NULL si el valor del parámetro requerido es FALSE y no se encuentra un espacio de nombres coincidente.

Nota 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 espacio de nombres "http://www.w3.org/XML/1998/namespace" devolverá el prefijo "xml".

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

El prefijo devuelto no debe modificarse y solo es válido hasta que avance el escritor.

Requisitos

Requisito Value
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