WsWriteXmlnsAttribute 関数 (webservices.h)

Xmlns 属性を現在の要素に書き込みます。 WsWriteStartElement は、属性を書き込む前に呼び出す必要があります。また、属性の数がライターで許可されている属性の最大数を超えた場合、関数は WS_E_QUOTA_EXCEEDED返します。 ( 「Windows Web Services の戻り値」を参照してください)。

構文

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] writer

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

[in, optional] prefix

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

xmlns 属性に使用するプレフィックスを指定します。

[in] ns

プレフィックスにバインドする名前空間へのWS_XML_STRING ポインター。

[in] singleQuote

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

[in, optional] error

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

戻り値

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

注釈

次の条件が適用されます：

• 空のプレフィックスが指定されている場合は、既定の名前空間が割り当てられます。
• NULL プレフィックスが指定されている場合、ライターは名前空間の適切なプレフィックスを選択します。
• Xmlns 属性が冗長である場合は、書き込むことができません。
• 空でないプレフィックスが空の名前空間で指定されている場合 WS_E_INVALID_FORMAT が返されます。

要件