Edit

IMsTscAxEvents::OnRemoteProgramResult method

  • Article

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
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IMsTscAxEvents is defined as 336d5562-efa8-482e-8cb3-c5c0fc7a7db6

See also

IMsTscAxEvents