IWSMan::CreateSession メソッド (wsmandisp.h)

後続のネットワーク操作に使用できる Session オブジェクトを作成します。

構文

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

パラメーター

[in] connection

IPv4 または IPv6 を含む、接続先のプロトコルとサービス。 接続情報の形式は、トランスポート><アドレス><サフィックス>です<。 例については、「解説」を参照してください。 接続情報が指定されていない場合は、ローカル コンピューターが使用されます。

[in] flags

リモート コンピューターに接続するための認証方法 ( ネゴシエート認証 や ダイジェスト認証など) を指定するセッション フラグ。 これらのフラグは、エンコードや暗号化など、他のセッション接続情報も指定します。 このパラメーターには、リモート接続の __WSManSessionFlagsに 1 つ以上のフラグが含まれている必要があります。 詳細については、「 セッション定数」を参照してください。 ローカル コンピューター上の WinRM サービスへの接続にフラグ設定は必要ありません。

認証フラグが指定されていない場合は、次のいずれかの条件が満たされていない限り、Kerberos が使用されます。この場合、ネゴシエートが使用されます。

• 明示的な資格情報が指定され、宛先ホストが信頼されている
• 宛先ホストが "localhost"、"127.0.0.1" または "[::1]"
• クライアント コンピューターがワークグループ内にあり、宛先ホストが信頼されている

詳細については、「 リモート接続の認証 」および 「connectionOptions パラメーター」を参照してください。

[in] connectionOptions

ユーザー名とパスワードを含む IWSManConnectionOptions オブジェクトへのポインター。 既定値は NULL です。

[out] session

新しい IWSManSession オブジェクトへのポインター。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

次の一覧には、接続パラメーターで接続情報を指定するために使用される形式の例が含まれています (HTTPS セッションを作成する場合、[アドレス>] < フィールドはサーバー コンピューターの証明書名と一致する必要があります。それ以外の場合はエラーが発生します)。

• "https://service"

  HTTPS を使用して、既定の Web サービスの場所に接続します。

• "https://service.corp.com/websvcs/wsman"

  HTTPS を使用して、特定の Web サービスの場所に接続します。

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

  既定のポートで HTTPS と IPv6 を使用します。

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"

  指定されたポートで HTTPS と IPv6 を使用します。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wsmandisp.h
Library	WSManDisp.tlb
[DLL]	WSMAuto.dll

関連項目

IWSMan

WSMan.CreateSession