Partager via

Fonction WTSGetListenerSecurityA (wtsapi32.h)

  • Article

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 de 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 dans un 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 les valeurs suivantes :

  • 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 connexion.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Combine les valeurs suivantes :

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Combine les valeurs suivantes :

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

Droit à la déconnexion.

WTS_SECURITY_GUEST_ACCESS

Défini comme WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

Droit de déconnexion.

WTS_SECURITY_LOGON (32 (0x20))

Droit de connexion.

WTS_SECURITY_MESSAGE (128 (0x80))

Droit d’envoyer un message à l’utilisateur.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

Droit de demander 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 les valeurs suivantes :

  • 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 ; dans le cas contraire, aucune action n’est prise.

Valeur retournée

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étaillées sur l’erreur, 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 lpnLengthNeededed , le nombre d’octets requis pour la mémoire tampon. Allouez la mémoire tampon en fonction de ce nombre, puis appelez à nouveau la méthode, en définissant pSecurityDescriptor sur la mémoire tampon nouvellement allouée et nLength sur le numéro retourné par le premier appel.

Notes

L’en-tête wtsapi32.h définit WTSGetListenerSecurity comme un 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7
Serveur minimal pris en charge Windows Server 2008 R2
Plateforme cible Windows
En-tête wtsapi32.h
Bibliothèque Wtsapi32.lib
DLL Wtsapi32.dll

Voir aussi

SECURITY_DESCRIPTOR

SECURITY_INFORMATION