WsWriteStartElement 関数 (webservices.h)

ライターに開始要素を書き込みます。

この関数を呼び出した後 、WsWriteStartAttribute または WsWriteXmlnsAttribute を呼び出して、要素に追加の属性を書き込むことができます。 コンテンツを書き込む WsWriteEndElement またはその他の関数が呼び出されるまで、要素はライターにコミットされません。

構文

HRESULT WsWriteStartElement(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] writer

start 要素が書き込まれる WS_XML_WRITER オブジェクトへのポインター。 ポインターは、有効な XML ライター オブジェクトを参照する必要があります。

[in, optional] prefix

start 要素に使用するプレフィックスへのWS_XML_STRINGポインター。 このパラメーターによって参照される値が NULL の 場合、Writer は属性を選択します。

[in] localName

start 要素で使用されるローカル名へのWS_XML_STRING ポインター。 少なくとも 1 文字の長さにする必要があります。

[in] ns

start 要素に使用する名前空間へのWS_XML_STRINGポインター。

プレフィックスが指定されていない場合、Writer は、指定された名前空間にバインドされているスコープでプレフィックスを使用するか、プレフィックスを生成して XMLNS 属性を含めることができます。 プレフィックスが指定されている場合、Writer はそのプレフィックスを使用し、スコープ内の既存のプレフィックスをオーバーライドするために必要な場合は XMLNS 属性を含めることができます。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

注釈

基になるエンコードで空の要素がサポートされていて、 要素にコンテンツがない場合は、空の要素が書き込まれます。

空でないプレフィックスが空の名前空間で指定されている場合 WS_E_INVALID_FORMAT が返されます。

start 要素を記述すると、 WS_XML_WRITER_PROPERTY_MAX_DEPTH を超える WS_E_QUOTA_EXCEEDED が返されます。 ( 「Windows Web サービスの戻り値」を参照してください)。

WS_XML_WRITER_MTOM_ENCODINGを使用する場合、名前空間http://www.w3.org/2004/08/xop/include"から localName "Include" を使用して要素を書き込もうとするとエラーになります。

WsWriteStartAttribute を使用すると、 ライターが WsMoveWriter または WsSetWriterPosition を使用して要素に配置されるときに、要素に属性を追加することもできます。

要件