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

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

メモWS_XML_WRITER_BINARY_ENCODINGが設定されている場合、引用符文字は保持されず、このパラメーターは無効になります。

 

[in, optional] error

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

戻り値

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

リターン コード 説明
E_INVALIDARG
1 つ以上の引数が無効です。
WS_E_INVALID_OPERATION
オブジェクトの現在の状態のため、操作は許可されません。
WS_E_INVALID_FORMAT
入力データの形式が正しくないか、予期した値が指定されていませんでした。
WS_E_QUOTA_EXCEEDED
クォータを超えました。

注釈

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

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

要件

要件
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll