IWSManConnectionOptions
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IWSManConnectionOptions オブジェクトは IWSMan::CreateSession メソッドに渡され、リモートコンピューター上のローカルアカウントに関連付けられたユーザー名とパスワードを提供します。
解説(Remarks)
Windows Remote Management クライアントアプリケーションが偽装 (impersonation) 下で実行されている場合、Password プロパティを設定すると失敗します。クライアントアプリケーションとは、ローカルまたはリモートのコンピューター上の WinRM に要求を送信するスクリプトやその他のプログラムです。クライアントアプリケーションは、ImpersonateClient のような関数を呼び出したために偽装下で実行されている場合があります。Active Server Page (ASP) やサービスは、ASP プロセスがクライアントを偽装するアカウント下で実行されている場合、ユーザー名とパスワードを要求できません。
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
リモートコンピューター上のローカルアカウントまたはドメインアカウントのユーザー名を設定および取得します。このプロパティは、認証に使用するユーザー名を決定します。(Get)
| name | LPWSTR* | out | 接続に使用するユーザー名を受け取る。 |
解説(Remarks)
Negotiate または Kerberos 認証を使用する場合はドメインアカウントに対して、Basic 認証を使用する場合はローカルアカウントに対して、UserName と Password を指定できます。ローカルアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseBasic フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseNegotiate フラグと WsmanFlagCredUserNamePassword フラグの組み合わせ、または WSManFlagUseKerberos フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントの場合、UserName は "computer\username" の形式で指定する必要があり、文字列の "computer" 部分は名前または IP アドレスのいずれかにできます。詳細については、Authentication for Remote Connections を参照してください。
リモートコンピューター上のローカルアカウントまたはドメインアカウントのユーザー名を設定および取得します。このプロパティは、認証に使用するユーザー名を決定します。(Put)
| name | LPWSTR | in | 接続に使用するユーザー名を指定する。 |
解説(Remarks)
Negotiate または Kerberos 認証を使用する場合はドメインアカウントに対して、Basic 認証を使用する場合はローカルアカウントに対して、UserName と Password を指定できます。ローカルアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseBasic フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseNegotiate フラグと WsmanFlagCredUserNamePassword フラグの組み合わせ、または WSManFlagUseKerberos フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントの場合、UserName は "computer\username" の形式で指定する必要があり、文字列の "computer" 部分は名前または IP アドレスのいずれかにできます。詳細については、Authentication for Remote Connections を参照してください。
リモートコンピューター上のローカルアカウントまたはドメインアカウントのパスワードを設定します。
| password | LPWSTR | in | 接続に使用するパスワードを指定する。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWSManConnectionOptions "{F704E861-9E52-464F-B786-DA5EB2320FDD}" #usecom global IWSManConnectionOptions IID_IWSManConnectionOptions "{}" #comfunc global IWSManConnectionOptions_get_UserName 7 var #comfunc global IWSManConnectionOptions_put_UserName 8 wstr #comfunc global IWSManConnectionOptions_put_Password 9 wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWSManConnectionOptions "{F704E861-9E52-464F-B786-DA5EB2320FDD}" #usecom global IWSManConnectionOptions IID_IWSManConnectionOptions "{}" #comfunc global IWSManConnectionOptions_get_UserName 7 sptr #comfunc global IWSManConnectionOptions_put_UserName 8 wstr #comfunc global IWSManConnectionOptions_put_Password 9 wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。