Funzione WTSEnumerateServersA (wtsapi32.h)

Articolo
11/20/2024

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 su cui 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll

Vedere anche

WTS_SERVER_INFO

Condividi tramite