Win32 API 日本語リファレンス
ホーム › System.RemoteDesktop › IWorkspaceScriptable

IWorkspaceScriptable

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDefea49a2-dda5-429d-8f42-b23b92c4c347継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 7

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT DisconnectWorkspace(LPWSTR bstrWorkspaceId)
bstrWorkspaceIdLPWSTRin切断するワークスペースの ID を指定する。
vtbl 8 HRESULT StartWorkspace(LPWSTR bstrWorkspaceId, LPWSTR bstrUserName, LPWSTR bstrPassword, LPWSTR bstrWorkspaceParams, INT lTimeout, INT lFlags)
bstrWorkspaceIdLPWSTRin開始するワークスペースの ID を指定する。
bstrUserNameLPWSTRin接続に使用するユーザー名を指定する。
bstrPasswordLPWSTRin接続に使用するパスワードを指定する。
bstrWorkspaceParamsLPWSTRinワークスペースに渡すパラメータ文字列を指定する。
lTimeoutINTin接続のタイムアウト時間を指定する。
lFlagsINTin開始時の動作を制御するフラグを指定する。
vtbl 9 HRESULT IsWorkspaceCredentialSpecified(LPWSTR bstrWorkspaceId, VARIANT_BOOL bCountUnauthenticatedCredentials, VARIANT_BOOL* pbCredExist)
bstrWorkspaceIdLPWSTRin資格情報の有無を確認するワークスペースの ID を指定する。
bCountUnauthenticatedCredentialsVARIANT_BOOLin未認証の資格情報を計上対象に含めるかどうかを指定する。
pbCredExistVARIANT_BOOL*out指定したワークスペースの資格情報が存在するかどうかを示すブール値を受け取る。
vtbl 10 HRESULT IsWorkspaceSSOEnabled(VARIANT_BOOL* pbSSOEnabled)
pbSSOEnabledVARIANT_BOOL*outワークスペースでシングルサインオンが有効かどうかを示すブール値を受け取る。
vtbl 11 HRESULT ClearWorkspaceCredential(LPWSTR bstrWorkspaceId)
bstrWorkspaceIdLPWSTRin資格情報をクリアするワークスペースの ID を指定する。
vtbl 12 HRESULT OnAuthenticated(LPWSTR bstrWorkspaceId, LPWSTR bstrUserName)
bstrWorkspaceIdLPWSTRin認証が完了したワークスペースの ID を指定する。
bstrUserNameLPWSTRin認証されたユーザーの名前を指定する。
vtbl 13 HRESULT DisconnectWorkspaceByFriendlyName(LPWSTR bstrWorkspaceFriendlyName)
bstrWorkspaceFriendlyNameLPWSTRin切断するワークスペースのフレンドリ名を指定する。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWorkspaceScriptable "{EFEA49A2-DDA5-429D-8F42-B23B92C4C347}"
#usecom global IWorkspaceScriptable IID_IWorkspaceScriptable "{}"
#comfunc global IWorkspaceScriptable_DisconnectWorkspace                7 wstr
#comfunc global IWorkspaceScriptable_StartWorkspace                     8 wstr,wstr,wstr,wstr,int,int
#comfunc global IWorkspaceScriptable_IsWorkspaceCredentialSpecified     9 wstr,int,var
#comfunc global IWorkspaceScriptable_IsWorkspaceSSOEnabled              10 var
#comfunc global IWorkspaceScriptable_ClearWorkspaceCredential           11 wstr
#comfunc global IWorkspaceScriptable_OnAuthenticated                    12 wstr,wstr
#comfunc global IWorkspaceScriptable_DisconnectWorkspaceByFriendlyName  13 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。