IRDPSRAPIViewer::RequestControl-Methode (rdpencomapi.h)
[Die IRDPSRAPIViewer-Schnittstelle ist ab Windows 10 Version 1709 nicht mehr für UWP-Anwendungen verfügbar. Es wird weiterhin für Desktop-Apps unterstützt.]
Fordert den Sharer auf, die Steuerungsebene des Viewers zu ändern. Nachdem diese Methode aufgerufen wurde, wird eine Nachricht an den Freigebenden gesendet, um den Freigebenden darüber zu informieren, dass ein Viewer eine Änderung der Steuerungsebene anfordert. Nachdem der Mitbenenner die Nachricht empfangen hat, wird auf der Seite der Teilnehmer ein Ereignis ausgelöst, um die Anwendung zu benachrichtigen, dass ein Teilnehmer eine Änderung der Steuerungsebene anfordert. Die Anwendung oder der Benutzer kann dann entscheiden, ob die angeforderte Steuerungsebene für einen Teilnehmer zugelassen werden soll.
Syntax
HRESULT RequestControl(
[in] CTRL_LEVEL CtrlLevel
);
Parameter
[in] CtrlLevel
Typ: CTRL_LEVEL
Einer der Werte der CTRL_LEVEL-Enumeration .
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist der Rückgabewert ein Fehlercode.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rdpencomapi.h |
| DLL | RdpEncom.dll |