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

IWSManConnectionOptions

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDf704e861-9e52-464f-b786-da5eb2320fdd継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

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。

vtbl 7 HRESULT get_UserName(LPWSTR* name)

リモートコンピューター上のローカルアカウントまたはドメインアカウントのユーザー名を設定および取得します。このプロパティは、認証に使用するユーザー名を決定します。(Get)

nameLPWSTR*out接続に使用するユーザー名を受け取る。

解説(Remarks)

Negotiate または Kerberos 認証を使用する場合はドメインアカウントに対して、Basic 認証を使用する場合はローカルアカウントに対して、UserNamePassword を指定できます。ローカルアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseBasic フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseNegotiate フラグと WsmanFlagCredUserNamePassword フラグの組み合わせ、または WSManFlagUseKerberos フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントの場合、UserName は "computer\username" の形式で指定する必要があり、文字列の "computer" 部分は名前または IP アドレスのいずれかにできます。詳細については、Authentication for Remote Connections を参照してください。

vtbl 8 HRESULT put_UserName(LPWSTR name)

リモートコンピューター上のローカルアカウントまたはドメインアカウントのユーザー名を設定および取得します。このプロパティは、認証に使用するユーザー名を決定します。(Put)

nameLPWSTRin接続に使用するユーザー名を指定する。

解説(Remarks)

Negotiate または Kerberos 認証を使用する場合はドメインアカウントに対して、Basic 認証を使用する場合はローカルアカウントに対して、UserNamePassword を指定できます。ローカルアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseBasic フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントに接続するには、WSMan.CreateSession のフラグに WSManFlagUseNegotiate フラグと WsmanFlagCredUserNamePassword フラグの組み合わせ、または WSManFlagUseKerberos フラグと WsmanFlagCredUserNamePassword フラグの組み合わせが含まれている必要があります。ドメインアカウントの場合、UserName は "computer\username" の形式で指定する必要があり、文字列の "computer" 部分は名前または IP アドレスのいずれかにできます。詳細については、Authentication for Remote Connections を参照してください。

vtbl 9 HRESULT put_Password(LPWSTR password)

リモートコンピューター上のローカルアカウントまたはドメインアカウントのパスワードを設定します。

passwordLPWSTRin接続に使用するパスワードを指定する。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 不要)。