IWRdsProtocolConnection
COM公式ドキュメント
クライアント接続を構成するためにリモートデスクトップサービスのサービスから呼び出されるメソッドを公開します。
解説(Remarks)
このインターフェイスのいずれかのメソッドを呼び出す際にデッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
メソッド 24
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
クライアントのログオンエラーをプロトコルがどのように処理すべきかを指定する IWRdsProtocolLogonErrorRedirector インターフェイスを取得します。
| ppLogonErrorRedir | IWRdsProtocolLogonErrorRedirector** | out | IWRdsProtocolLogonErrorRedirector インターフェイスへのポインターのアドレス。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
この関数を実装しない場合は、ログオンエラーをリダイレクトすべきではないことを示すために E_NOTIMPL を返してください。
接続要求を続行するようプロトコルに指示します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
エラーを受け取ると、リモートデスクトップサービスのサービスは接続を切断します。
プロトコルからクライアント設定を要求します。
| pClientData | WTS_CLIENT_DATA* | out | クライアント設定を格納する WRDS_CLIENT_DATA 構造体へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
エラーを受け取ると、リモートデスクトップサービスのサービスは接続を切断します。
クライアント上のモニターの数とプライマリモニターの番号を取得します。
| pNumMonitors | DWORD* | out | カウントされたモニターの数を受け取る UINT 変数へのポインター。 |
| pPrimaryMonitor | DWORD* | out | クライアント上のプライマリモニターの番号を受け取る UINT 変数へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ユーザーの資格情報を返します。
| pUserCreds | WTS_USER_CREDENTIAL* | out | 資格情報を格納する WRDS_USER_CREDENTIAL 構造体へのポインター。現在サポートされているのはユーザー名、パスワード、ドメインのみです。ユーザー名とパスワードはプレーンテキストです。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
プロトコルが HRESULT エラーコードを返した場合、またはユーザーが正しくない資格情報を入力した場合、WinLogon は資格情報を要求するためのログオン画面を表示します。プロトコルが S_OK を返した場合、資格情報は WinLogon に渡されてユーザーのログオンに使用されます。
クライアントのライセンス処理を開始するために使用される IWRdsProtocolLicenseConnection オブジェクトを取得します。
| ppLicenseConnection | IWRdsProtocolLicenseConnection** | out | ライセンス接続オブジェクトを受け取る IWRdsProtocolLicenseConnection インターフェイスへのポインターのアドレス。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーを受け取ると、リモートデスクトップサービスのサービスは接続を切断します。
接続の再接続先となるセッションを指定します。
| SessionId | WTS_SESSION_ID* | out | セッションを一意に識別する WRDS_SESSION_ID 構造体へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
エラーを受け取ると、リモートデスクトップサービスのサービスは接続シーケンスを続行します。
新しいセッションの識別子をプロトコルに送信します。
| SessionId | WTS_SESSION_ID* | in | セッションを一意に識別する WRDS_SESSION_ID 構造体へのポインター。 |
| SessionHandle | HANDLE_PTR | in | セッションハンドル。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
プロトコルの入出力デバイスへのハンドルを取得します。
| pKeyboardHandle | HANDLE_PTR* | out | キーボードデバイスのハンドルを受け取るハンドルへのポインター。これは I8042prt キーボードドライバーへのハンドルです。 |
| pMouseHandle | HANDLE_PTR* | out | マウスデバイスのハンドルを受け取るハンドルへのポインター。これは Mouclass ドライバーへのハンドルです。 |
| pBeepHandle | HANDLE_PTR* | out | ビープまたはサウンドデバイスのハンドルを受け取るハンドルへのポインター。このハンドルは使用されず、NULL に設定する必要があります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルのビデオデバイスのハンドルを取得します。
| pVideoHandle | HANDLE_PTR* | out | ビデオデバイスのハンドルを受け取るハンドルへのポインター。 プロトコルオブジェクトが IWRdsRemoteFXGraphicsConnection インターフェイスを使用している場合、このメソッドは pVideoHandle の内容を NULL に設定し、E_NOTIMPL を返す必要があります。 プロトコルが IWRdsRemoteFXGraphicsConnection インターフェイスを使用していない場合、このメソッドはプロトコルに関連付けられたリモートセッションのビデオミニポートドライバーへのハンドルを返す必要があります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
セッションが初期化されたことをプロトコルに通知します。
| SessionId | DWORD | in | セッション識別子。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
ユーザーがセッションへのログオンを許可されているかどうかをプロトコルから判定します。
| SessionId | DWORD | in | セッション識別子。 |
| UserToken | HANDLE_PTR | in | ユーザートークンを表すハンドル。 |
| pDomainName | LPWSTR | in | ユーザーのドメイン名を格納する null 終端文字列へのポインター。 |
| pUserName | LPWSTR | in | ユーザー名を格納する null 終端文字列へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
アービトレーションの後に呼び出され、再接続するセッションをプロトコルが指定できるようにします。
| hUserToken | HANDLE_PTR | in | ユーザートークンを表すハンドル。 |
| bSingleSessionPerUserEnabled | BOOL | in | ユーザーが単一のセッションにのみ関連付けられるかどうかを指定します。 |
| pSessionIdArray | DWORD* | out | ユーザーの切断されたセッション識別子を受け取る ULONG 配列へのポインター。このパラメーターが NULL の場合、リモートデスクトップサービスのサービスはこの配列を割り当てるための要素数を要求しています。識別子の数を pdwSessionIdentifierCount が指す値に格納してください。 |
| pdwSessionIdentifierCount | DWORD* | inout | pSessionIdArray 配列内の要素数を受け取る ULONG 値へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ユーザーがセッションにログオンしたときに呼び出されます。
| hClientToken | HANDLE_PTR | in | ユーザートークンを表すハンドル。 |
| wszUserName | LPWSTR | in | ユーザー名を格納する null 終端文字列へのポインター。 |
| wszDomainName | LPWSTR | in | ユーザーのドメイン名を格納する null 終端文字列へのポインター。 |
| SessionId | WTS_SESSION_ID* | in | セッションを一意に識別する WRDS_SESSION_ID 構造体へのポインター。 |
| pWRdsConnectionSettings | WRDS_CONNECTION_SETTINGS* | inout | セッションの接続設定を格納する WRDS_CONNECTION_SETTINGS 構造体へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
セッションが間もなく切断されることをプロトコルに通知します。
| DisconnectReason | DWORD | in | 切断の理由を示す数値。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
セッションが切断されたことをプロトコルに通知します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
セッションが切断された後に接続を閉じます。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルのステータスに関する情報を取得します。
| pProtocolStatus | WTS_PROTOCOL_STATUS* | out | プロトコルのカウンター、シグナル、キャッシュの情報を受け取る WRDS_PROTOCOL_STATUS 構造体へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルが最後にユーザー入力を受け取った時刻を取得します。
| pLastInputTime | ULONGLONG* | out | プロトコルが最後に入力を受け取ってから経過したミリ秒数を受け取る ULONG64 値へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルにエラー情報を設定します。
| ulError | DWORD | in | エラーコード。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルに仮想チャネルの作成を要求します。
| szEndpointName | LPSTR | in | 接続を一意に識別するエンドポイントデータを格納する null 終端文字列。 |
| bStatic | BOOL | in | 仮想チャネルが静的か動的かを指定します。 TRUEチャネルは静的です。 FALSEチャネルは動的です。 |
| RequestedPriority | DWORD | in | チャネルに要求される優先度を指定します。 |
| phChannel | UINT_PTR* | out | 作成されたチャネルのハンドルを受け取る ULONG 値へのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
仮想チャネルは、リモートデスクトップサービスのアプリケーションを拡張するために作成できるソフトウェア拡張です。例としては、追加のハードウェアのサポートや、特定のプロトコルが提供する機能への追加などがあります。詳細については、「リモートデスクトップサービスの仮想チャネル」を参照してください。
プロトコルからプロパティ値を取得します。
| QueryType | GUID | in | 要求されたプロパティを指定する GUID。次のいずれかの値を指定できます。 WRDS_QUERY_ALLOWED_INITIAL_APP (C77D1B30-5BE1-4c6b-A0E1-BD6D2E5C9FCC)初期アプリケーションの実行を許可すべきかどうかを判定するために、リモートデスクトップサービスのサービスから送信されます。 入力時、リモートデスクトップサービスのサービスは pPropertyEntriesIn パラメーターで 3 つの WRDS_PROPERTY_VALUE 構造体を渡します。 入力構造体 1:
出力構造体 1:
WRDS_QUERY_LOGON_SCREEN_SIZE (8b8e0fe7-0804-4a0e-b279-8660b1df0049)ログオン画面のサイズを判定するために WinLogon によって使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 pPropertyEntriesOut パラメーターを次のように設定します。
WRDS_QUERY_AUDIOENUM_DLL (9bf4fa97-c883-4c2a-80ab-5a39c9af00db)リモートオーディオ列挙子 DLL の名前を照会するために、リモートデスクトップサービスのサービスによって使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 pPropertyEntriesOut パラメーターを次のように設定します。
WRDS_QUERY_MF_FORMAT_SUPPORT (41869ad0-6332-4dc8-95d5-db749e2f1d94)特定のメディア形式に使用するシンクオブジェクトを判定するために、リモートデスクトップ Media Foundation プラグインによって使用されます。 入力時、RCM は pPropertyEntriesIn パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
PROPERTY_DYNAMIC_TIME_ZONE_INFORMATION (cdfd28e-d0b9-4c1f-a5eb-6d1f6c6535b9)接続から動的タイムゾーン情報を取得するために使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
CONNECTION_PROPERTY_CURSOR_BLINK_DISABLED (4b150580-fea4-4d3c-9de4-7433a66618f7)カーソルの点滅を無効にすべきかどうかを判定するために使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
PROPERTY_TYPE_GET_FAST_RECONNECT (6212d757-0043-4862-99c3-9f3059ac2a3b)使用する再接続のモードを判定するために、リモートデスクトップサービスのサービスによって使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
PROPERTY_TYPE_GET_FAST_RECONNECT_USER_SID (197c427a-0135-4b6d-9c5e-e6579a0ab625)拡張高速再接続の際に、再接続先セッションのフィルターに使用されるユーザー SID を取得するために、リモートデスクトップサービスのサービスによって使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
PROPERTY_TYPE_ENABLE_UNIVERSAL_APPS_FOR_CUSTOM_SHELL (ed2c3fda-338d-4d3f-81a3-e767310d908e)セッション作成中に、カスタムシェルの前に ShellAppRuntime.exe を起動するかどうかを判定するために、リモートデスクトップサービスのサービスによって使用されます。ShellAppRuntime.exe はカスタムシェルのユニバーサルアプリサポートを実装します。これは既定では有効になっていません (ゼロを渡すのと同等)。これは Server 2019 以降、または Windows 10 マルチセッション Build 18950 以降の Windows バージョンで利用できます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
CONNECTION_PROPERTY_IDLE_TIME_WARNING (693f7ff5-0c4e-4d17-b8e0-1f70325e5d58)アイドルタイマーの期限が切れたときにログオフ警告プロンプトを表示するかどうかを判定するために使用されます。 pPropertyEntriesIn パラメーターは NULL になります。 出力時、pPropertyEntriesOut パラメーターで次の WRDS_PROPERTY_VALUE 構造体を渡します。
|
| ulNumEntriesIn | DWORD | in | pPropertyEntriesIn 配列内のエントリ数。 |
| ulNumEntriesOut | DWORD | in | pPropertyEntriesOut 配列内のエントリ数。 |
| pPropertyEntriesIn | WTS_PROPERTY_VALUE* | in | 要求されたプロパティ情報を見つけるのに役立てることができる WRDS_PROPERTY_VALUE 構造体へのポインターの配列。 |
| pPropertyEntriesOut | WTS_PROPERTY_VALUE* | out | 要求されたプロパティ値を受け取る WRDS_PROPERTY_VALUE 構造体へのポインターの配列。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
プロトコルからシャドウ接続オブジェクトへの参照を取得します。
| ppShadowConnection | IWRdsProtocolShadowConnection** | out | シャドウ接続オブジェクトへの参照を受け取る IWRdsProtocolShadowConnection インターフェイスポインターのアドレス。このメソッドは戻る前にオブジェクトへの参照を追加する必要があります。リモートデスクトップサービスのサービスがオブジェクトを不要になると、それを解放します。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Winlogon.exe プロセスが作成され初期化されたことをプロトコルに通知します。
| SessionId | DWORD | in | セッション識別子。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
これはイベント通知であり、このメソッドからは直ちに戻る必要があります。デッドロックが発生する可能性を回避するため、直接的または間接的にリモートデスクトップサービスの API 呼び出しを引き起こすような関数やメソッドの呼び出しを行わないでください。外部への呼び出しを行う必要がある場合は、新しいスレッドを開始し、その新しいスレッドから外部への呼び出しを行ってください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWRdsProtocolConnection "{324ED94F-FDAF-4FF6-81A8-42ABE755830B}" #usecom global IWRdsProtocolConnection IID_IWRdsProtocolConnection "{}" #comfunc global IWRdsProtocolConnection_GetLogonErrorRedirector 3 sptr #comfunc global IWRdsProtocolConnection_AcceptConnection 4 #comfunc global IWRdsProtocolConnection_GetClientData 5 var #comfunc global IWRdsProtocolConnection_GetClientMonitorData 6 var,var #comfunc global IWRdsProtocolConnection_GetUserCredentials 7 var #comfunc global IWRdsProtocolConnection_GetLicenseConnection 8 sptr #comfunc global IWRdsProtocolConnection_AuthenticateClientToSession 9 var #comfunc global IWRdsProtocolConnection_NotifySessionId 10 var,sptr #comfunc global IWRdsProtocolConnection_GetInputHandles 11 var,var,var #comfunc global IWRdsProtocolConnection_GetVideoHandle 12 var #comfunc global IWRdsProtocolConnection_ConnectNotify 13 int #comfunc global IWRdsProtocolConnection_IsUserAllowedToLogon 14 int,sptr,wstr,wstr #comfunc global IWRdsProtocolConnection_SessionArbitrationEnumeration 15 sptr,int,var,var #comfunc global IWRdsProtocolConnection_LogonNotify 16 sptr,wstr,wstr,var,var #comfunc global IWRdsProtocolConnection_PreDisconnect 17 int #comfunc global IWRdsProtocolConnection_DisconnectNotify 18 #comfunc global IWRdsProtocolConnection_Close 19 #comfunc global IWRdsProtocolConnection_GetProtocolStatus 20 var #comfunc global IWRdsProtocolConnection_GetLastInputTime 21 var #comfunc global IWRdsProtocolConnection_SetErrorInfo 22 int #comfunc global IWRdsProtocolConnection_CreateVirtualChannel 23 str,int,int,var #comfunc global IWRdsProtocolConnection_QueryProperty 24 int,int,int,var,var #comfunc global IWRdsProtocolConnection_GetShadowConnection 25 sptr #comfunc global IWRdsProtocolConnection_NotifyCommandProcessCreated 26 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWRdsProtocolConnection "{324ED94F-FDAF-4FF6-81A8-42ABE755830B}" #usecom global IWRdsProtocolConnection IID_IWRdsProtocolConnection "{}" #comfunc global IWRdsProtocolConnection_GetLogonErrorRedirector 3 sptr #comfunc global IWRdsProtocolConnection_AcceptConnection 4 #comfunc global IWRdsProtocolConnection_GetClientData 5 sptr #comfunc global IWRdsProtocolConnection_GetClientMonitorData 6 sptr,sptr #comfunc global IWRdsProtocolConnection_GetUserCredentials 7 sptr #comfunc global IWRdsProtocolConnection_GetLicenseConnection 8 sptr #comfunc global IWRdsProtocolConnection_AuthenticateClientToSession 9 sptr #comfunc global IWRdsProtocolConnection_NotifySessionId 10 sptr,sptr #comfunc global IWRdsProtocolConnection_GetInputHandles 11 sptr,sptr,sptr #comfunc global IWRdsProtocolConnection_GetVideoHandle 12 sptr #comfunc global IWRdsProtocolConnection_ConnectNotify 13 int #comfunc global IWRdsProtocolConnection_IsUserAllowedToLogon 14 int,sptr,wstr,wstr #comfunc global IWRdsProtocolConnection_SessionArbitrationEnumeration 15 sptr,int,sptr,sptr #comfunc global IWRdsProtocolConnection_LogonNotify 16 sptr,wstr,wstr,sptr,sptr #comfunc global IWRdsProtocolConnection_PreDisconnect 17 int #comfunc global IWRdsProtocolConnection_DisconnectNotify 18 #comfunc global IWRdsProtocolConnection_Close 19 #comfunc global IWRdsProtocolConnection_GetProtocolStatus 20 sptr #comfunc global IWRdsProtocolConnection_GetLastInputTime 21 sptr #comfunc global IWRdsProtocolConnection_SetErrorInfo 22 int #comfunc global IWRdsProtocolConnection_CreateVirtualChannel 23 str,int,int,sptr #comfunc global IWRdsProtocolConnection_QueryProperty 24 int,int,int,sptr,sptr #comfunc global IWRdsProtocolConnection_GetShadowConnection 25 sptr #comfunc global IWRdsProtocolConnection_NotifyCommandProcessCreated 26 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。