WS_READ_TYPE_CALLBACK Rückruffunktion (webservices.h)

Artikel
2023-08-27

Liest einen Wert, wenn WS_TYPE angegeben wurde. Dies ermöglicht das Lesen von XML-Konstrukten, die nicht einfach dem Kernserialisierungsmodell zugeordnet werden können.

Syntax

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

Parameter

[in] reader

Ein Zeiger auf ein WS_XML_READER Handle, das den Typwert enthält.

[in] typeMapping

Gibt an, wie die XML-Datei diesem Typ zugeordnet wird.

Wenn eine Zuordnung für diesen bestimmten Typ nicht sinnvoll ist, sollte der Rückruf WS_E_INVALID_OPERATION zurückgeben. (Siehe Rückgabewerte für Windows-Webdienste.) Eine Rückrufimplementierung sollte so vorbereitet sein, dass neue Zuordnungstypen in zukünftigen Versionen übergeben werden, und für diese Fälle sollte WS_E_INVALID_OPERATION zurückgegeben werden.

[in] descriptionData

Ein Zeiger auf den Wert des DescriptionData-Felds einer WS_CUSTOM_TYPE_DESCRIPTION-Struktur . Der Rückruf kann dies verwenden, um Zugriff auf zusätzliche Informationen über den Typ zu erhalten.

[in, optional] heap

Ein Zeiger auf den Heap zur Zuweisung zusätzlicher Daten, die diesem Typ zugeordnet sind, z. B. die geschachtelten Felder.

Beachten Sie, dass dieser Parameter null sein kann, wenn der Aufrufer beim Deserialisieren des Typs kein WS_HEAP -Objekt angegeben hat.

value

Ein Zeiger auf einen Puffer, der den Wert enthält, der deserialisiert wird. Der Rückruf ist dafür verantwortlich, den Wert basierend auf dem aktuellen Inhalt des Readers und dem typeMapping auszufüllen. Der Rückruf kann bei Bedarf den angegebenen Heap verwenden, um dem Wert zugeordnete Werte zuzuweisen.

[in] valueSize

Die Puffergröße, die deserialisiert wird. Der Puffer wird entsprechend der im WS_CUSTOM_TYPE_DESCRIPTION angegebenen Größe zugeordnet.

[in, optional] error

Ein Zeiger auf WS_ERROR Datenstruktur, in der zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Hinweise

Der Rückruf wird mit derselben Aufrufsequenz wie WsReadType in der Dokumentation für WS_TYPE_MAPPING aufgerufen. Dadurch wird definiert, welche Teile des XML-Codes vom Rückruf gelesen werden sollen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Freigeben über