WTSEnumerateListenersA 函数 (wtsapi32.h)

枚举远程桌面会话主机 (RD 会话主机) 服务器上的所有远程桌面服务侦听器。

语法

BOOL WTSEnumerateListenersA(
  [in]            HANDLE            hServer,
  [in]            PVOID             pReserved,
  [in]            DWORD             Reserved,
  [out, optional] PWTSLISTENERNAMEA pListeners,
  [in, out]       DWORD             *pCount
);

参数

[in] hServer

RD 会话主机服务器的句柄。 始终将此参数设置为 WTS_CURRENT_SERVER_HANDLE。

[in] pReserved

此参数为保留参数。 始终将此参数设置为 NULL。

[in] Reserved

此参数为保留参数。 始终将此参数设置为零。

[out, optional] pListeners

指向接收侦听器名称的 WTSLISTENERNAME 变量数组的指针。

[in, out] pCount

指向 DWORD 变量的指针，该变量包含 pListeners 参数引用的数组中的侦听器名称数。 如果侦听器名称数未知，请将 pListeners 传递为 NULL。 该函数将返回为 pListeners 参数指向的数组分配所需的 WTSLISTENERNAME 变量数。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数返回服务器上当前运行的所有侦听器，包括不支持远程桌面协议 (RDP) 的侦听器。

如果侦听器数未知，则可以调用此函数，并将 pListeners 设置为 NULL。 然后，该函数将在 pCount 参数中返回接收所有侦听器所需的 WTSLISTENERNAME 变量数。 根据此数字为 pListeners 分配数组，然后再次调用函数，将 pListeners 设置为新分配的数组，将 pCount 设置为第一次调用返回的数字。

要求