Compartir a través de

Función WsWriteQualifiedName (webservices.h)

  • Artículo

Escribe un nombre completo XML en el escritor.

Sintaxis

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escribe el nombre completo. El puntero debe hacer referencia a un objeto xml Writer válido.

[in, optional] prefix

Puntero WS_XML_STRING al prefijo usado por el nombre completo. Si el valor al que hace referencia este parámetro es NULL , el escritor elegirá un prefijo.

[in] localName

Puntero WS_XML_STRING al nombre local usado por el nombre completo. Debe tener al menos un carácter largo.

[in, optional] ns

Puntero WS_XML_STRING al espacio de nombres usado para el nombre completo.

Si no se especifica ningún prefijo, el escritor puede usar un prefijo en el ámbito enlazado al espacio de nombres especificado o puede generar un prefijo e incluir un atributo XMLNS.

Si se especifica un prefijo, el escritor usa ese prefijo y puede incluir un atributo XMLNS si es necesario para invalidar un prefijo existente en el ámbito.

[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
E_INVALIDARG
 Uno o más argumentos no son válidos.
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.

Comentarios

  • Si el prefijo es NULL, el espacio de nombres no debe ser NULL. En este caso, el escritor intentará buscar un prefijo en el ámbito enlazado al espacio de nombres especificado. Si se encuentra un prefijo adecuado, se usará. Si no es así, el escritor generará un prefijo e insertará un atributo XMLNS en el elemento actual. Si el escritor no está en un elemento, la función devolverá WS_E_INVALID_FORMAT.

    (Consulte Valores devueltos de servicios web de Windows).

  • Si el prefijo no es NULL y el espacio de nombres no es NULL , el escritor comprobará que el prefijo está enlazado actualmente al espacio de nombres especificado y devolverá WS_E_INVALID_FORMAT si no es así.
  • Si el prefijo no es NULL y el espacio de nombres es NULL , el escritor usará el prefijo y el nombre local para escribir el nombre completo.

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