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 オブジェクトへのポインター。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
入力データが予期された形式でなかったか、予期された値を持っていませんでした。 |
注釈
名前空間 "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 |