ホーム › Networking.WindowsWebServices › WS_WRITE_TYPE_CALLBACK

WS_WRITE_TYPE_CALLBACK

コールバック

シグネチャ

HRESULT WS_WRITE_TYPE_CALLBACK(
    WS_XML_WRITER* writer,
    WS_TYPE_MAPPING typeMapping,
    void* descriptionData,
    void* value,
    DWORD valueSize,
    WS_ERROR* error
);

パラメーター

フィールド	型	説明
writer	WS_XML_WRITER*	値の書き込み先となるライターへの WS_XML_WRITER ポインター。
typeMapping	WS_TYPE_MAPPING	XML がこの型にどのようにマップされるかを示します。詳細については WS_TYPE_MAPPING を参照してください。この型に対してそのマッピングが適切でない場合、コールバックは WS_E_INVALID_OPERATION を返す必要があります (Windows Web Services の戻り値を参照してください)。コールバックの実装は、将来のバージョンで新しいマッピング型が渡される場合に備え、そのような場合には WS_E_INVALID_OPERATION を返すようにしてください。
descriptionData	void*	WS_CUSTOM_TYPE_DESCRIPTION 構造体の descriptionData フィールドの値です。コールバックはこのフィールドを使用して、その型に関する追加情報にアクセスします。
value	void*	シリアル化する値への void ポインター。
valueSize	DWORD	シリアル化される値のサイズ (バイト単位)。
error	WS_ERROR*	関数が失敗した場合に追加のエラー情報を格納する WS_ERROR データ構造体へのポインター。

公式ドキュメント

WS_CUSTOM_TYPE が指定されている場合に、要素を書き込むために呼び出されます。これにより、コアのシリアル化モデルには容易にマップできない XML 構造を書き込めます。

戻り値

このコールバック関数は値を返しません。

解説(Remarks)

このコールバックは、WS_TYPE_MAPPING のドキュメントに記載されている WsWriteType と同じ呼び出し手順で呼び出されます。これにより、コールバックが書き込むべき XML の部分が決まります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)