Funzione WTSQueryListenerConfigA (wtsapi32.h)

Articolo
03/04/2024

Recupera le informazioni di configurazione per un listener di Servizi Desktop remoto.

Sintassi

BOOL WTSQueryListenerConfigA(
  [in]  HANDLE              hServer,
  [in]  PVOID               pReserved,
  [in]  DWORD               Reserved,
  [in]  LPSTR               pListenerName,
  [out] PWTSLISTENERCONFIGA pBuffer
);

Parametri

[in] hServer

Handle per un server host sessione Desktop remoto. Impostare sempre questo parametro su WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Questo parametro è riservato. Impostare sempre questo parametro su NULL.

[in] Reserved

Questo parametro è riservato. Impostare sempre questo parametro su zero.

[in] pListenerName

Puntatore a una stringa con terminazione null contenente il nome del listener da eseguire per la query.

[out] pBuffer

Puntatore a una struttura WTSLISTENERCONFIG che riceve le informazioni di configurazione del listener recuperato.

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 sull'errore estese, chiamare la funzione GetLastError .

Commenti

Questa funzione non recupera il descrittore di sicurezza per il listener. Per recuperare il descrittore di sicurezza, chiamare la funzione WTSGetListenerSecurity .

Nota

L'intestazione wtsapi32.h definisce WTSQueryListenerConfig 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 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll

Vedi anche

WTSGetListenerSecurity

WTSLISTENERCONFIG

Condividi tramite