WsGetNamespaceFromPrefix 関数 (webservices.h)

この関数は、バインド先のプレフィックスから名前空間を返します。

必須パラメーターの値が TRUE に設定されていて、Prefix が名前空間にバインドされていない場合は、WS_E_INVALID_FORMAT例外が返されます。 ( 「Windows Web Services の戻り値」を参照してください)。 必須 パラメーターが FALSE で、Prefix が名前空間にバインドされていない場合、 ns パラメーターは NULL になり、関数はS_FALSEを返します。

構文

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] reader

プレフィックスを検索するリーダーへのポインター。

[in] prefix

検索するプレフィックスへのポインター。

[in] required

この Boolean パラメーターの値は、一致する名前空間が見つからない場合にエラーを返す必要があるかどうかを決定します。

ns

成功した場合にプレフィックスがバインドされる名前空間への参照。 返される値は、ライターが進むまで有効です。

[in, optional] error

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

戻り値

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

リターン コード	説明
WS_E_INVALID_FORMAT	入力データの形式が正しくないか、予期した値が指定されていませんでした。

解説

プレフィックス "xml" の場合、名前空間 "http://www.w3.org/XML/1998/namespace"" が返されます。

プレフィックス "xmlns" の場合、名前空間 "http://www.w3.org/2000/xmlns/"" が返されます。

要件

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