Compartir a través de

Función WsCreateXmlBuffer (webservices.h)

  • Artículo

Crea un búfer XML que se puede usar para procesar datos XML.

Sintaxis

HRESULT WsCreateXmlBuffer(
  [in]           WS_HEAP                      *heap,
                 const WS_XML_BUFFER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_BUFFER                **buffer,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] heap

Puntero a la estructura WS_HEAP que representa el montón desde el que se va a asignar memoria para el búfer XML devuelto.

properties

Matriz de WS_XML_BUFFER_PROPERTY estructuras que contienen propiedades opcionales para el búfer XML.

El valor de este parámetro puede ser NULL, en cuyo caso el parámetro propertyCount debe ser 0 (cero).

[in] propertyCount

Número de propiedades de la matriz de propiedades .

buffer

Si se ejecuta correctamente, un puntero que recibe la dirección de la estructura WS_XML_BUFFER que representa el búfer XML creado. La memoria de este búfer se libera cuando se restablece o libera su montón.

El búfer XML está inicialmente vacío.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
E_INVALIDARG
 Uno o más argumentos no son válidos.

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