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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista with SP1
サポートされる最小サーバー	Windows Server 2008
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	wtsapi32.h
ライブラリ	Wtsapi32.lib
DLL	Wtsapi32.dll