IWSDXMLContext::AddNamespace メソッド (wsdxml.h)
XML コンテキスト内の名前空間を表す オブジェクトを作成します。 名前空間が既に存在する場合、新しい名前空間は追加されません。既存の名前の名前空間オブジェクトが返されます。
構文
HRESULT AddNamespace(
[in] LPCWSTR pszUri,
[in] LPCWSTR pszSuggestedPrefix,
[out] WSDXML_NAMESPACE **ppNamespace
);
パラメーター
[in] pszUri
名前空間の URI。
[in] pszSuggestedPrefix
XML の生成時に使用する名前空間プレフィックス。 名前空間が既に存在する場合、 pszSuggestedPrefix は、現在名前空間に関連付けられているプレフィックスを上書きします。 XML コンテキストは、別の名前空間プレフィックスを割り当てることができます。 XML コンテキストによって割り当てられたプレフィックスは、推奨されるプレフィックスよりも優先されます。 ppNamespace が指す構造体の PreferredPrefix メンバーには、XML コンテキストによって割り当てられたプレフィックスが含まれています。
[out] ppNamespace
名前空間を表す WSDXML_NAMESPACE 構造体のアドレスへのポインター。 WSDFreeLinkedMemory を呼び出して、ppNamespace の割り当てを解除する必要があります。 このパラメーターは省略できます。
戻り値
可能な戻り値は次のとおりですが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
pszUri が NULL、URI 文字列の文字数がWSD_MAX_TEXT_LENGTH (8192)、 pszSuggestedPrefix が NULL、またはプレフィックス文字列の文字数が WSD_MAX_TEXT_LENGTH (8192) を超えています。 |
|
操作を完了するためのメモリ不足。 |
|
メソッドが失敗しました。 |
注釈
返された WSDXML_NAMESPACE 構造体を使用して、名前空間プレフィックス ( pszSuggestedPrefix で指定) と名前空間 URI ( pszUri で指定) の間の関連付けを強制できます。 この関連付けが確立されると、XML ジェネレーターは、指定された名前空間プレフィックスを持つ XML を生成します。
AddNamespace を呼び出して、AddNameToNamespace の呼び出しによって名前空間が自動的に生成されたときに作成されたWSDXML_NAMESPACE構造体を取得できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wsdxml.h (Wsdapi.h を含む) |
[DLL] | Wsdapi.dll |