次の方法で共有


WsGetPrefixFromNamespace 関数 (webservices.h)

この関数は、名前空間がバインドされているプレフィックスを返します。 スコープ内に複数のプレフィックスが存在する可能性があり、この関数はそれらのいずれかを自由に返します。

メモ 返される可能性のあるプレフィックスが複数ある場合、呼び出し元が特定のプレフィックスに依存したり、特定のプレフィックスが返されることを想定したりすることはできません。
 

必須パラメーターの値が TRUE に設定されていて、Namespace がプレフィックスにバインドされていない場合は、WS_E_INVALID_FORMAT例外が返されます。 ( 「Windows Web サービスの戻り値」を参照してください)。 必要な パラメーターが FALSE で、Namespace が Prefix にバインドされていない場合、 プレフィックス パラメーターは NULL であり、関数はS_FALSEを返します。

WsWriteStartElement が呼び出されても、要素がコミットされていない場合は、要素によって参照される名前空間とプレフィックスがコミットされず、要素の属性はこの関数で使用できません。

構文

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

パラメーター

[in] writer

検索する名前空間を持つ Writer へのポインター。 これは、WsCreateWriter によって返される有効なWS_XML_WRITER オブジェクトである必要があり、NULL にすることはできません。

[in] ns

検索する名前空間。

[in] required

一致するプレフィックスが見つからない場合にエラーを返すかどうかを示します。

prefix

必要なパラメーターの値が FALSE で、一致する名前空間が見つからない場合は、名前空間にバインドされたプレフィックスへの参照または NULL

メモ 返される値は、ライターが進むまで有効です。

 

[in, optional] error

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

戻り値

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

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

注釈

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

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

返されるプレフィックスは変更しないでください。これは、ライターが進むまで有効です。

要件

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