WsWriteStartAttribute 関数 (webservices.h)

この操作により、現在の要素への属性の書き込みが開始されます。 WsWriteStartElement は、属性を書き込む前に呼び出す必要があります。 属性が開始されたら、WsWriteChars、WsWriteBytes、または WsWriteValue を使用して属性値を書き込むことができます。 属性は 、WsWriteEndAttribute を使用して完了する必要があります。

構文

HRESULT WsWriteStartAttribute(
  [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]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] writer

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

[in, optional] prefix

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

[in] localName

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

[in] ns

属性に使用する名前空間へのWS_XML_STRING ポインター。

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

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

[in] singleQuote

属性値に単一引用符と二重引用符のどちらを使用するかを決定します。

[in, optional] error

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

戻り値

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

注釈

NULL プレフィックスが指定されている場合、ライターは名前空間のプレフィックスを選択します。

"xml:lang" または "xml:space" 属性を記述するには、プレフィックスに "xml" を指定し、localName に "lang" または "space" を指定し、"http://www.w3.org/XML/1998/namespace"名前空間の 。

属性を記述すると 、WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES が超過した場合 は、WS_E_QUOTA_EXCEEDED が返されます。

空でないプレフィックスが空の名前空間で指定されている場合 WS_E_INVALID_FORMAT が返されます。 ( 「Windows Web Services の戻り値」を参照してください)。

要件