Windows Dev Center

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.

ValueMeaning
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

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

 

 

Show:
© 2015 Microsoft