WS_READ_TYPE_CALLBACK funzione di callback (webservices.h)

Articolo
08/27/2023

Legge un valore quando è stato specificato WS_TYPE . Ciò consente la lettura di costrutti XML che non vengono facilmente mappati al modello di serializzazione principale.

Sintassi

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
)
{...}

Parametri

[in] reader

Puntatore a un handle WS_XML_READER contenente il valore del tipo.

[in] typeMapping

Indica come viene eseguito il mapping del codice XML a questo tipo.

Se un mapping non ha senso per questo tipo specifico, il callback deve restituire WS_E_INVALID_OPERATION. Vedere Valori restituiti da Servizi Web Windows. Un'implementazione di callback deve essere preparata per essere passata a nuovi tipi di mapping nelle versioni future e deve restituire WS_E_INVALID_OPERATION per tali casi.

[in] descriptionData

Puntatore al valore del campo descriptionData di una struttura di WS_CUSTOM_TYPE_DESCRIPTION . Il callback può usarlo per ottenere l'accesso a eventuali informazioni aggiuntive sul tipo.

[in, optional] heap

Puntatore all'heap da usare per l'allocazione di eventuali dati aggiuntivi associati a questo tipo, ad esempio i relativi campi annidati.

Si noti che questo parametro può essere NULL, se il chiamante non ha specificato un oggetto WS_HEAP durante la deserializzazione del tipo.

value

Puntatore a un buffer che contiene il valore deserializzato. Il callback è responsabile del riempimento del valore in base al contenuto corrente del lettore e al tipoMapping. Il callback può usare l'heap fornito, se necessario per allocare valori associati al valore.

[in] valueSize

Dimensioni del buffer deserializzate. Il buffer viene allocato in base alle dimensioni specificate nella WS_CUSTOM_TYPE_DESCRIPTION.

[in, optional] error

Puntatore a WS_ERROR struttura di dati in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Commenti

Il callback verrà richiamato con la stessa sequenza chiamante di WsReadType nella documentazione per WS_TYPE_MAPPING. Ciò definisce le parti del codice XML che il callback deve leggere.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h

Share via