次の方法で共有

WSManSetSessionOption 関数 (wsman.h)

  • [アーティクル]

セッションのオプションの拡張セットを設定します。

構文

DWORD WSManSetSessionOption(
  [in] WSMAN_SESSION_HANDLE session,
       WSManSessionOption   option,
  [in] WSMAN_DATA           *data
);

パラメーター

[in] session

WSManCreateSession 呼び出しによって返されるセッション ハンドルを指定します。 このパラメーターを NULL にすることはできません。

option

設定するオプションを指定します。 このパラメーターは、 WSManSessionOption 列挙の値のいずれかに設定する必要があります。

[in] data

オプション値を定義する WSMAN_DATA 構造体へのポインター。

戻り値

このメソッドは、成功すると 0 を返します。 それ以外の場合、このメソッドはエラー コードを返します。

注釈

WSManSetSessionOption メソッドが、オプション パラメーターに対して異なる値を指定して呼び出される場合は、さまざまなオプションの順序が重要です。 WSManSetSessionOption が初めて呼び出されると、トランスポートがセッションに設定されます。 2 番目の呼び出しで別の種類のトランスポートが要求された場合、呼び出しは失敗します。

たとえば、メソッドが次の順序で呼び出されると、2 番目のメソッド呼び出しは失敗します。

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
オプション パラメーターが WSMAN_OPTION_UNENCRYPTED_MESSAGES に設定されているため、最初のメソッド呼び出しではトランスポートが HTTP に設定されます。 2 番目の呼び出しは失敗します。これは、渡されたオプションが HTTPS に適用され、トランスポートが最初のメッセージによって HTTP に設定されているためです。

要件

要件 値
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
対象プラットフォーム Windows
ヘッダー wsman.h
Library WsmSvc.lib
[DLL] WsmSvc.dll
再頒布可能パッケージ WINDOWS Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework