WTSEnumerateListenersW

RD セッションホストサーバー上の全リモートデスクトップサービスリスナーを列挙する。(Unicode)

WTSEnumerateListenersW hServer, pReserved, Reserved, pListeners, pCount

hServer : [intptr] RD セッションホストサーバーへのハンドル。常に WTS_CURRENT_SERVER_HANDLE に設定する。
pReserved : [intptr] このパラメータは予約されている。常に NULL に設定する。
Reserved : [int] このパラメータは予約されている。常に 0 に設定する。
pListeners : [var] リスナー名を受け取る WTSLISTENERNAME 配列へのポインタ。
pCount : [var] pListeners 配列内のリスナー名数を含む DWORD 変数へのポインタ。リスナー数が不明なら pListeners に NULL を渡すと必要な WTSLISTENERNAME 変数の数が返される。

(プラグイン / モジュール : wtsapi32.dll)

解説

RD セッションホストサーバー上の全リモートデスクトップサービスリスナーを列挙する。(Unicode)

[戻り値]
関数が成功すると戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
この関数はサーバー上で現在動作中の全リスナーを返す (RDP をサポートしないものも含む)。リスナー数が不明な場合、pListeners
を NULL にして呼ぶと pCount に必要数が返る。その数で配列を確保し、pListeners を新しい配列、pCount
を最初の呼び出しで返された数にして再度呼ぶ。
> [!NOTE] > wtsapi32.h は WTSEnumerateListeners を ANSI/Unicode
自動選択エイリアスとして定義している。

情報