WS_READ_TYPE_CALLBACK función de devolución de llamada (webservices.h)

Lee un valor cuando se ha especificado WS_TYPE . Esto permite la lectura de construcciones XML que no se asignan fácilmente al modelo de serialización principal.

Sintaxis

WS_READ_TYPE_CALLBACK WsReadTypeCallback;

HRESULT WsReadTypeCallback(
  [in]           WS_XML_READER *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           const void *descriptionData,
  [in, optional] WS_HEAP *heap,
                 void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

Parámetros

[in] reader

Puntero a un identificador de WS_XML_READER que contiene el valor de tipo.

[in] typeMapping

Indica cómo se asigna el XML a este tipo.

Si una asignación no tiene sentido para este tipo determinado, la devolución de llamada debe devolver WS_E_INVALID_OPERATION. (Vea Valores devueltos de servicios web de Windows). Se debe preparar una implementación de devolución de llamada para pasar nuevos tipos de asignación en versiones futuras y devolver WS_E_INVALID_OPERATION para esos casos.

[in] descriptionData

Puntero al valor del campo descriptionData de una estructura de WS_CUSTOM_TYPE_DESCRIPTION . La devolución de llamada puede usarla para obtener acceso a cualquier información adicional sobre el tipo.

[in, optional] heap

Puntero al montón para su uso en la asignación de datos adicionales asociados a este tipo, como sus campos anidados.

Tenga en cuenta que este parámetro puede ser NULL, si el autor de la llamada no especificó un objeto WS_HEAP al deserializar el tipo.

value

Puntero a un búfer que contiene el valor que se está deserializando. La devolución de llamada es responsable de rellenar el valor en función del contenido actual del lector y del typeMapping. La devolución de llamada puede usar el montón proporcionado si es necesario para asignar valores asociados al valor.

[in] valueSize

Tamaño del búfer que se está deserializando. El búfer se asigna según el tamaño especificado en el WS_CUSTOM_TYPE_DESCRIPTION.

[in, optional] error

Puntero a WS_ERROR estructura de datos donde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función de devolución de llamada no devuelve un valor.

Comentarios

La devolución de llamada se invocará con la misma secuencia de llamada que WsReadType en la documentación de WS_TYPE_MAPPING. Esto define qué partes del XML debe leer la devolución de llamada.

Requisitos

Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	webservices.h