ホーム › System.DeploymentServices › IWdsTransportNamespaceManager
IWdsTransportNamespaceManager
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
WDS トランスポートサーバー上の名前空間を管理します。
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
vtbl 7 HRESULT CreateNamespace(WDSTRANSPORT_NAMESPACE_TYPE NamespaceType, LPWSTR bszNamespaceName, LPWSTR bszContentProvider, LPWSTR bszConfiguration, IWdsTransportNamespace** ppWdsTransportNamespace)
現在の WDS トランスポートサーバーに登録できる IWdsTransportNamespace インターフェイスのオブジェクトを作成します。
| NamespaceType | WDSTRANSPORT_NAMESPACE_TYPE | in | 新しい名前空間オブジェクトの種類。WDSTRANSPORT_NAMESPACE_TYPE 列挙体に列挙されている名前空間の種類のいずれかを指定できます。 |
| bszNamespaceName | LPWSTR | in | 新しい名前空間オブジェクトの名前。アプリケーションがこの名前空間を WDS トランスポートサーバーに登録しようとすると、WDS は名前が一意であることを確認します。 |
| bszContentProvider | LPWSTR | in | 新しい名前空間オブジェクトに関連付けるコンテンツプロバイダーの名前。 |
| bszConfiguration | LPWSTR | in | コンテンツプロバイダーが使用する構成情報。この情報の形式はコンテンツプロバイダーによって定義されます。パラメーターが不要な場合は空の文字列を指定できます。 |
| ppWdsTransportNamespace | IWdsTransportNamespace** | out | このメソッドによって作成された IWdsTransportNamespace インターフェイスのオブジェクトへのポインター。 |
戻り値
標準的な HRESULT エラー値が使用されます。成功時は S_OK、失敗時はそれ以外の値になります。
vtbl 8 HRESULT RetrieveNamespace(LPWSTR bszNamespaceName, IWdsTransportNamespace** ppWdsTransportNamespace)
IWdsTransportNamespace インターフェイスのオブジェクトを名前で取得します。この名前は WDS トランスポートサーバー上の名前空間に登録されている必要があります。
| bszNamespaceName | LPWSTR | in | オブジェクトを返す対象となる名前空間の名前。この名前空間は WDS トランスポートサーバーに登録されている必要があります。 |
| ppWdsTransportNamespace | IWdsTransportNamespace** | out | 指定された名前に一致する IWdsTransportNamespace インターフェイスのオブジェクトへのポインター。 |
戻り値
標準的な HRESULT エラー値が使用されます。成功時は S_OK、失敗時はそれ以外の値になります。
vtbl 9 HRESULT RetrieveNamespaces(LPWSTR bszContentProvider, LPWSTR bszNamespaceName, VARIANT_BOOL bIncludeTombstones, IWdsTransportCollection** ppWdsTransportNamespaces)
指定した条件に一致するサーバー上の名前空間を表す IWdsTransportNamespace インターフェイスのオブジェクトのコレクションを返します。
| bszContentProvider | LPWSTR | in | 名前空間を返す対象となるコンテンツプロバイダーの名前。空の文字列を指定すると、すべてのコンテンツプロバイダーの名前空間を返します。 |
| bszNamespaceName | LPWSTR | in | インスタンスを返す対象となる名前空間の名前。空の文字列を指定すると、選択したコンテンツプロバイダーのすべての名前空間を返します。 |
| bIncludeTombstones | VARIANT_BOOL | in | true を指定すると、サーバー上にアクティブなセッションが残ったまま登録解除された名前空間も結果に含めるようメソッドに指示します。これにより、アプリケーションはその名前で別の名前空間を登録できます。 |
| ppWdsTransportNamespaces | IWdsTransportCollection** | out | IWdsTransportCollection インターフェイスのオブジェクトへのポインター。これは、指定した条件に一致する IWdsTransportNamespace インターフェイスのオブジェクトのコレクションを表します。 |
戻り値
標準的な HRESULT エラー値が使用されます。成功時は S_OK、失敗時はそれ以外の値になります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWdsTransportNamespaceManager "{3E22D9F6-3777-4D98-83E1-F98696717BA3}"
#usecom global IWdsTransportNamespaceManager IID_IWdsTransportNamespaceManager "{F08CDB63-85DE-4A28-A1A9-5CA3E7EFDA73}"
#comfunc global IWdsTransportNamespaceManager_CreateNamespace 7 int,wstr,wstr,wstr,sptr
#comfunc global IWdsTransportNamespaceManager_RetrieveNamespace 8 wstr,sptr
#comfunc global IWdsTransportNamespaceManager_RetrieveNamespaces 9 wstr,wstr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。