Compartir a través de

Función WTSEnumerateServersA (wtsapi32.h)

  • Artículo

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 estructuras de WTS_SERVER_INFO , 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 ppServerInfo .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wtsapi32.h
Library Wtsapi32.lib
Archivo DLL Wtsapi32.dll

Consulte también

WTS_SERVER_INFO