WTSSendMessageA, fonction (wtsapi32.h)

Article
11/20/2024

Affiche une boîte de message sur le bureau client d’une session services Bureau à distance spécifiée.

Syntaxe

BOOL WTSSendMessageA(
  [in]  HANDLE hServer,
  [in]  DWORD  SessionId,
  [in]  LPSTR  pTitle,
  [in]  DWORD  TitleLength,
  [in]  LPSTR  pMessage,
  [in]  DWORD  MessageLength,
  [in]  DWORD  Style,
  [in]  DWORD  Timeout,
  [out] DWORD  *pResponse,
  [in]  BOOL   bWait
);

Paramètres

[in] hServer

Handle vers un serveur hôte de session Bureau à distance. Spécifiez un handle ouvert par la fonction WTSOpenServer, ou spécifiez WTS_CURRENT_SERVER_HANDLE pour indiquer le serveur hôte de session Bureau à distance sur lequel votre application s’exécute.

[in] SessionId

Identificateur de session des services Bureau à distance. Pour indiquer la session active, spécifiez WTS_CURRENT_SESSION. Vous pouvez utiliser la fonction WTSEnumerateSessions pour récupérer les identificateurs de toutes les sessions sur un serveur hôte de session Bureau à distance spécifié.

Pour envoyer un message à la session d’un autre utilisateur, vous devez disposer de l’autorisation Message. Pour plus d’informations, consultez Services Bureau à distance
Autorisations. Pour modifier les autorisations sur une session, utilisez l’outil d’administration des services Bureau à distance.

[in] pTitle

Pointeur vers une chaîne terminée par null pour la barre de titre de la zone de message.

[in] TitleLength

Longueur, en octets, de la chaîne de barre de titre.

[in] pMessage

Pointeur vers une chaîne terminée par null qui contient le message à afficher.

[in] MessageLength

Longueur, en octets, de la chaîne de message.

[in] Style

Contenu et comportement de la boîte de message. Cette valeur est généralement MB_OK. Pour obtenir la liste complète des valeurs, consultez le paramètre uType de la fonction MessageBox .

[in] Timeout

Temps, en secondes, que la fonction WTSSendMessage attend la réponse de l’utilisateur. Si l’utilisateur ne répond pas dans l’intervalle de délai d’attente, le paramètre pResponse retourne IDTIMEOUT. Si le paramètre Timeout est égal à zéro, WTSSendMessage attend indéfiniment que l’utilisateur réponde.

[out] pResponse

Pointeur vers une variable qui reçoit la réponse de l’utilisateur, qui peut être l’une des valeurs suivantes.

IDABORT (3)

abandonner

IDCANCEL (2)

Annuler

IDCONTINUE (11)

Continuer

IDIGNORE (5)

Ignorer

IDNO (7)

Aucun

IDOK (1)

IDRETRY (4)

réessayer

IDTRYAGAIN (10)

réessayer

IDYES (6)

Oui

IDASYNC (32001 (0x7D01))

Le paramètre bWait a été FALSE, de sorte que la fonction retournée sans attendre une réponse.

IDTIMEOUT (32000 (0x7D00))

Le paramètre bWait était TRUE et l’intervalle de délai d’attente s’est écoulé.

[in] bWait

Si TRUE, WTSSendMessage ne retourne pas tant que l’utilisateur ne répond pas ou que l’intervalle de délai d’attente s’écoule. Si le paramètre timeout est égal à zéro, la fonction ne retourne pas tant que l’utilisateur ne répond pas.

Si FALSE, la fonction retourne immédiatement et le paramètre pResponse retourne IDASYNC . Utilisez cette méthode pour les messages d’informations simples (tels que les messages d’impression de notification de travail) qui n’ont pas besoin de renvoyer la réponse de l’utilisateur au programme appelant.

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 GetLastError.

Remarques

Note

L’en-tête wtsapi32.h définit WTSSendMessage comme 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 Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	wtsapi32.h
bibliothèque	Wtsapi32.lib
DLL	Wtsapi32.dll

Voir aussi

messageBox

Partager via