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

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

メモ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 プレフィックスが指定されている場合、ライターは名前空間のプレフィックスを選択します。

"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 の戻り値」を参照してください)。

要件

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