WsCreateXmlBuffer 関数 (webservices.h)

XML データの処理に使用できる XML バッファー を作成します。

構文

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

パラメーター

[in] heap

返された XML バッファーのメモリを割り当てるヒープを表すWS_HEAP構造体へのポインター。

properties

XML バッファーの省略可能なプロパティを含む WS_XML_BUFFER_PROPERTY 構造体の配列。

このパラメーターの値は NULL である可能性があります。この場合、 propertyCount パラメーターは 0 (ゼロ) である必要があります。

[in] propertyCount

プロパティ配列内の プロパティ の数。

buffer

成功した場合、作成された XML バッファーを表す WS_XML_BUFFER 構造体のアドレスを受け取るポインター。 このバッファーのメモリは、ヒープがリセットまたは解放されると解放されます。

XML バッファーは最初は空です。

[in, optional] error

関数が失敗した場合に追加のエラー情報を受け取る WS_ERROR 構造体へのポインター。

戻り値

関数が成功した場合は、NO_ERRORを返します。それ以外の場合は、HRESULT エラー コードを返します。

要件