Función WTSEnumerateServersA (wtsapi32.h)
Devuelve una lista de todos los servidores host de sesión de Escritorio remoto (host de sesión de Escritorio remoto) dentro del dominio especificado.
Sintaxis
BOOL WTSEnumerateServersA(
[in] LPSTR pDomainName,
[in] DWORD Reserved,
[in] DWORD Version,
PWTS_SERVER_INFOA *ppServerInfo,
DWORD *pCount
);
Parámetros
[in] pDomainName
Puntero al nombre del dominio que se va a consultar. Si el valor de este parámetro es NULL, el dominio especificado es el dominio actual.
[in] Reserved
Reservado. El valor de este parámetro debe ser 0.
[in] Version
Versión de la solicitud de enumeración. El valor del parámetro debe ser 1.
ppServerInfo
Apunta a una matriz de WTS_SERVER_INFO estructuras, que contiene los resultados devueltos de la enumeración. Después de su uso, la memoria usada por este búfer debe liberarse llamando a WTSFreeMemory.
pCount
Puntero a una variable que recibe el número de estructuras de WTS_SERVER_INFO devueltas en el búfer de ppServerInfo.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Esta función no funcionará si NetBT está deshabilitado.
Nota
El encabezado wtsapi32.h define WTSEnumerateServers como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de |
Windows |
| encabezado de |
wtsapi32.h |
| biblioteca de |
Wtsapi32.lib |
| DLL de |
Wtsapi32.dll |