Partager via


WTSGetListenerSecurityA, fonction (wtsapi32.h)

Récupère le descripteur de sécurité d’un écouteur des services Bureau à distance.

Syntaxe

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

Paramètres

[in] hServer

Handle vers un serveur hôte de session Bureau à distance. Définissez toujours ce paramètre sur WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Ce paramètre est réservé. Définissez toujours ce paramètre sur NULL.

[in] Reserved

Ce paramètre est réservé. Définissez toujours ce paramètre sur zéro.

[in] pListenerName

Pointeur vers une chaîne terminée par null qui contient le nom de l’écouteur.

[in] SecurityInformation

Valeur SECURITY_INFORMATION qui spécifie les informations de sécurité à récupérer. Activez toujours les indicateurs DACL_SECURITY_INFORMATION et SACL_SECURITY_INFORMATION.

Pour plus d’informations sur les valeurs possibles, consultez SECURITY_INFORMATION.

[out, optional] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR qui reçoit les informations de sécurité associées à l’écouteur référencé par le paramètre pListenerName. La structure SECURITY_DESCRIPTOR est retournée au format auto-relatif. Pour plus d’informations sur les valeurs possibles, consultez SECURITY_DESCRIPTOR.

La liste de contrôle d’accès discrétionnaire (DACL) du descripteur de sécurité peut contenir une ou plusieurs des valeurs suivantes.

WTS_SECURITY_ALL_ACCESS

Combine ces valeurs :

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT (256 (0x100))

Droit de se connecter.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Combine ces valeurs :

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Combine ces valeurs :

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

Droit de se déconnecter.

WTS_SECURITY_GUEST_ACCESS

Défini comme WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

Droit de se déconnecter.

WTS_SECURITY_LOGON (32 (0x20))

Droit de se connecter.

WTS_SECURITY_MESSAGE (128 (0x80))

Droit d’envoyer un message à l’utilisateur.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

Droit d’interroger des informations.

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

Droit d’utiliser le contrôle à distance.

WTS_SECURITY_RESET (4 (0x4))

Droit de réinitialiser les informations.

WTS_SECURITY_SET_INFORMATION (2 (0x2))

Droit de définir des informations.

WTS_SECURITY_USER_ACCESS

Combine ces valeurs :

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

Droit d’utiliser des canaux virtuels.

[in] nLength

Taille, en octets, de la structure SECURITY_DESCRIPTOR référencée par le paramètre pSecurityDescriptor.

[out] lpnLengthNeeded

Pointeur vers une variable qui reçoit le nombre d’octets requis pour stocker le descripteur de sécurité complet. Si ce nombre est inférieur ou égal à la valeur du paramètre nLength , le descripteur de sécurité est copié dans la structure SECURITY_DESCRIPTOR référencée par le paramètre pSecurityDescriptor  ; sinon, aucune action n’est prise.

Valeur de retour

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.

Remarques

Si le nombre d’octets nécessaires pour la mémoire tampon qui reçoit la structure SECURITY_DESCRIPTOR est inconnu, vous pouvez appeler cette méthode avec nLength défini sur zéro. La méthode retourne ensuite, dans le paramètre lpnLengthNeeded, le nombre d’octets requis pour la mémoire tampon. Allouez la mémoire tampon en fonction de ce numéro, puis appelez à nouveau la méthode, en définissant pSecurityDescriptor à la mémoire tampon nouvellement allouée et nLength au numéro retourné par le premier appel.

Note

L’en-tête wtsapi32.h définit WTSGetListenerSecurity en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows 7
serveur minimum pris en charge Windows Server 2008 R2
plateforme cible Windows
d’en-tête wtsapi32.h
bibliothèque Wtsapi32.lib
DLL Wtsapi32.dll

Voir aussi

SECURITY_DESCRIPTOR

SECURITY_INFORMATION