Funzione WTSEnumerateServersA (wtsapi32.h)

Articolo
08/28/2023

Restituisce un elenco di tutti i server Host sessione Desktop remoto (Host sessione Desktop remoto) all'interno del dominio specificato.

Sintassi

BOOL WTSEnumerateServersA(
  [in] LPSTR             pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOA *ppServerInfo,
       DWORD             *pCount
);

Parametri

[in] pDomainName

Puntatore al nome del dominio da eseguire una query. Se il valore di questo parametro è NULL, il dominio specificato è il dominio corrente.

[in] Reserved

Riservato. Il valore di questo parametro deve essere 0.

[in] Version

Versione della richiesta di enumerazione. Il valore del parametro deve essere 1.

ppServerInfo

Punta a una matrice di strutture WTS_SERVER_INFO , che contiene i risultati restituiti dell'enumerazione. Dopo l'uso, la memoria usata da questo buffer deve essere liberata chiamando WTSFreeMemory.

pCount

Puntatore a una variabile che riceve il numero di strutture WTS_SERVER_INFO restituite nel buffer ppServerInfo .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione non funzionerà se NetBT è disabilitato.

Nota

L'intestazione wtsapi32.h definisce WTSEnumerateServers come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll

Vedi anche

WTS_SERVER_INFO

Condividi tramite