WSManCreateSession 関数 (wsman.h)

セッション オブジェクトを作成します。

構文

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

パラメーター

[in] apiHandle

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

[in, optional] connection

接続するプロトコルとエージェントを示します。 このパラメーターが NULL の場合、接続は既定で localhost (127.0.0.1) になります。 このパラメーターには、単純なホスト名または完全な URL を指定できます。 形式は次のとおりです。

[transport://]host[:p ort][/prefix] where:

要素	説明
transport	HTTP または HTTPS のいずれか。 既定値は HTTP です。
host	DNS 名、NetBIOS 名、または IP アドレスを指定できます。
port	既定値は HTTP の場合は 80、HTTPS の場合は 443 です。 既定値は、ローカル構成で変更できます。
prefix	任意の文字列。 既定値は "wsman" です。 既定値は、ローカル構成で変更できます。

flags

将来利用するために予約されています。 ゼロを指定してください。

[in, optional] serverAuthenticationCredentials

ネゴシエート、Kerberos、Digest、Basic、クライアント証明書などの認証方法を定義します。 認証メカニズムが Negotiate、Kerberos、Digest、または Basic の場合、構造体には認証に使用される資格情報を含めることもできます。 クライアント証明書認証を使用する場合は、証明書の拇印を指定する必要があります。

資格情報が指定されている場合、このパラメーターにはローカル アカウントまたはドメイン アカウントのユーザー名とパスワードが含まれます。 このパラメーターが NULL の場合は、既定の資格情報が使用されます。 既定の資格情報は、現在のスレッドが実行している資格情報です。 基本認証またはダイジェスト認証を使用する場合、クライアントは資格情報を明示的に指定する必要があります。 明示的な資格情報を使用する場合は、ユーザー名とパスワードの両方が有効である必要があります。 認証資格情報の詳細については、「 WSMAN_AUTHENTICATION_CREDENTIALS 構造」を参照してください。

[in, optional] proxyInfo

プロキシ情報を指定する WSMAN_PROXY_INFO 構造体へのポインター。 この値は NULL にすることができます。

[out] session

セッションを一意に識別するセッション ハンドルを定義します。 このパラメーターを NULL にすることはできません。 このハンドルは、 WSManCloseSession メソッドを呼び出して閉じる必要があります。

戻り値

関数が成功した場合の戻り値は 0 です。 それ以外の場合、戻り値はエラー コードです。

要件

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