IMsTscAxEvents::OnRemoteProgramResult method
Called when a RemoteApp program returns a result to the client control.
Syntax
VOID OnRemoteProgramResult(
[in] BSTR bstrRemoteProgram,
[in] RemoteProgramResult lError,
[in] VARIANT_BOOL vbIsExecutable
);
Parameters
-
bstrRemoteProgram [in]
-
The name of the RemoteApp program.
-
lError [in]
-
The result of the attempt to launch the RemoteApp program.
-
remoteAppResultOk (0 (0x0))
-
The RemoteApp program launched successfully.
-
remoteAppResultLocked (1 (0x1))
-
The remote session is locked and the RemoteApp program cannot be launched. The user must enter their credentials to unlock the session, and then launch the RemoteApp program.
-
remoteAppResultProtocolError (2 (0x2))
-
The RemoteApp program returned a protocol error.
-
remoteAppResultNotInWhitelist (3 (0x3))
-
The RemoteApp program is not in the approved list of the RD Session Host server.
-
remoteAppResultNetworkPathDenied (4 (0x4))
-
The network path to the RemoteApp program was denied.
-
remoteAppResultFileNotFound (5 (0x5))
-
The RemoteApp program file was not found.
-
remoteAppResultFailure (6 (0x6))
-
The RemoteApp program failed to launch.
-
remoteAppResultHookNotLoaded (7 (0x7))
-
The RemoteApp program cannot be launched because the session is currently displaying the secure desktop.
vbIsExecutable [in]
Indicates whether the RemoteApp program was launched directly, by using the executable name or indirectly, by using a file association.
Return value
This method does not return a value.
Remarks
Implement this method in your event sink to receive notification that a RemoteApp program returned a result.
This method is called immediately after the ActiveX control attempts to launch the RemoteApp program, and the lError parameter indicates the result of the attempt.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 |
| Type library |
|
| DLL |
|
| IID |
IMsTscAxEvents is defined as 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |