Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

WTSEnumerateListeners function

Enumerates all the Remote Desktop Services listeners on a Remote Desktop Session Host (RD Session Host) server.

Syntax


BOOL WINAPI WTSEnumerateListeners(
  _In_      HANDLE            hServer,
  _In_      PVOID             pReserved,
  _In_      DWORD             Reserved,
  _Out_opt_ PWTSLISTENERNAME  pListeners,
  _Inout_   DWORD            *pCount
);

Parameters

hServer [in]

A handle to an RD Session Host server. Always set this parameter to WTS_CURRENT_SERVER_HANDLE.

pReserved [in]

This parameter is reserved. Always set this parameter to NULL.

Reserved [in]

This parameter is reserved. Always set this parameter to zero.

pListeners [out, optional]

A pointer to an array of WTSLISTENERNAME variables that receive the names of the listeners.

pCount [in, out]

A pointer to a DWORD variable that contains the number of listener names in the array referenced by the pListeners parameter. If the number of listener names is unknown, pass pListeners as NULL. The function will return the number of WTSLISTENERNAME variables necessary to allocate for the array pointed to by the pListeners parameter.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function returns all listeners currently running on the server, including listeners that do not support Remote Desktop Protocol (RDP).

If the number of listeners is unknown, you can call this function with pListeners set to NULL. The function will then return, in the pCount parameter, the number of WTSLISTENERNAME variables necessary to receive all the listeners. Allocate the array for pListeners based on this number, and then call the function again, setting pListeners to the newly allocated array and pCount to the number returned by the first call.

Requirements

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Wtsapi32.h

Library

Wtsapi32.lib

DLL

Wtsapi32.dll

Unicode and ANSI names

WTSEnumerateListenersW (Unicode) and WTSEnumerateListenersA (ANSI)

 

 

Show:
© 2015 Microsoft