WTSConnectSessionA 関数 (wtsapi32.h)

リモート デスクトップ サービス セッションをローカル コンピューター上の既存のセッションに接続します。

構文

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

パラメーター

[in] LogonId

接続するセッションのログオン ID。 そのセッションのユーザーは、既存のセッションに接続するためのアクセス許可を持っている必要があります。 このセッションの出力は、 TargetLogonId パラメーターによって識別されるセッションにルーティングされます。

これは、現在 の セッションを使用するためにLOGONID_CURRENTできます。

[in] TargetLogonId

LogonId パラメーターで表されるセッションの出力を受信するセッションのログオン ID。 LogonId パラメーターによって識別されるセッションの出力は、このセッションにルーティングされます。

これは、現在 の セッションを使用するためにLOGONID_CURRENTできます。

[in] pPassword

LogonId パラメーターで指定されたユーザー アカウントのパスワードへのポインター。 呼び出し元がログオン ID と同じドメイン名とユーザー名を使用してログオンしている場合、 pPassword の値は空の文字列にすることができます。 pPassword の値を NULL にすることはできません。

[in] bWait

操作が同期であるかどうかを示します。 操作が完了するのを待つ場合は TRUE 、直ちに 返すには FALSE を 指定します。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

LogonId パラメーターまたは TargetLogonId パラメーターをLOGONID_CURRENTできますが、両方を指定することはできません。

注意

wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSConnectSession を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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