WsWriteQualifiedName 関数 (webservices.h)
XML 修飾名をライターに書き込みます。
構文
HRESULT WsWriteQualifiedName(
[in] WS_XML_WRITER *writer,
[in, optional] const WS_XML_STRING *prefix,
[in] const WS_XML_STRING *localName,
[in, optional] const WS_XML_STRING *ns,
[in, optional] WS_ERROR *error
);
パラメーター
[in] writer
修飾名が書き込まれる WS_XML_WRITER オブジェクトへのポインター。 ポインターは、有効な XML ライター オブジェクトを参照する必要があります。
[in, optional] prefix
修飾名で使用されるプレフィックスへのWS_XML_STRING ポインター。 このパラメーターによって参照される値が NULL の 場合、Writer はプレフィックスを選択します。
[in] localName
修飾名で使用されるローカル名へのWS_XML_STRINGポインター。 少なくとも 1 文字の長さにする必要があります。
[in, optional] ns
修飾名に使用される名前空間へのWS_XML_STRING ポインター。
プレフィックスが指定されていない場合、Writer は、指定された名前空間にバインドされているスコープでプレフィックスを使用するか、プレフィックスを生成して XMLNS 属性を含めることができます。
プレフィックスが指定されている場合、Writer はそのプレフィックスを使用し、スコープ内の既存のプレフィックスをオーバーライドするために必要な場合は XMLNS 属性を含めることができます。
[in, optional] error
関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
1 つ以上の引数が無効です。 |
|
入力データが予期された形式でなかったか、予期された値を持っていませんでした。 |
解説
- プレフィックスが NULL の場合、名前空間を NULL にすることはできません。 この場合、ライターは、指定された名前空間にバインドされているスコープ内のプレフィックスを検索しようとします。 適切なプレフィックスが見つかった場合は、それを使用します。 そうでない場合、Writer はプレフィックスを生成し、現在の要素に XMLNS 属性を挿入します。 ライターが 要素にない場合、関数は WS_E_INVALID_FORMATを返します。
( 「Windows Web サービスの戻り値」を参照してください)。
- プレフィックスが NULL ではなく、名前空間が NULL でない場合、ライターはプレフィックスが現在指定された名前空間にバインドされていることを確認し、それ以外の場合は WS_E_INVALID_FORMAT を返します。
- プレフィックスが NULL ではなく、名前空間が NULL の 場合、Writer はプレフィックスとローカル名を使用して修飾名を書き込みます。
要件
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | webservices.h |
Library | WebServices.lib |
[DLL] | WebServices.dll |