Función WsWriteType (webservices.h)

  • Artículo

Escriba un valor de un WS_TYPE determinado en XML según el WS_TYPE_MAPPING.

Sintaxis

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parámetros

[in] writer

Escritor en el que se va a escribir el valor.

[in] typeMapping

Describe cómo se asigna el tipo al XML que se está escribiendo.

[in] type

Tipo del valor que se va a serializar.

[in, optional] typeDescription

Información adicional sobre el tipo. Cada tipo tiene una estructura de descripción diferente. Puede ser NULL, dependiendo del WS_TYPE.

[in] writeOption

Indica si se requiere el valor y cómo se asigna el valor. Consulte WS_WRITE_OPTION para obtener más información.

Este parámetro debe tener uno de los valores siguientes:

value

Puntero al valor que se va a serializar.

[in] valueSize

Tamaño del valor que se va a serializar.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional 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.
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Se quedó sin memoria.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Consulte WS_TYPE_MAPPING para obtener información sobre cómo usar esta función para escribir valores en elementos y atributos.

Si se produce un error en la API, el estado del escritor de entrada deja de definirse. Las únicas API que se pueden usar en el escritor si esto ocurre son WsSetOutput y WsSetOutputToBuffer para devolver el escritor a un estado utilizable, o WsFreeWriter para liberar al 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