smmsg.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_SM_CREATE_FOREIGN_SESSION_MSG
struct	_SM_SESSION_COMPLETE_MSG
struct	_SM_TERMINATE_FOREIGN_SESSION_MSG
struct	_SM_EXEC_PGM_MSG
struct	_SM_LOAD_DEFERED_SUBSYSTEM_MSG
struct	_SM_START_CSR_MSG
struct	_SM_STOP_CSR_MSG
struct	_SM_API_MSG
struct	_SB_CREATE_SESSION_MSG
struct	_SB_TERMINATE_SESSION_MSG
struct	_SB_FOREIGN_SESSION_COMPLETE_MSG
struct	_SB_CREATE_PROCESS_MSG
struct	_SB_CONNECTION_INFO
struct	_SB_API_MSG

Macros
#define	SB_PROCESS_FLAGS_DEBUG   0x1
#define	SB_PROCESS_FLAGS_WAIT_ON_THREAD   0x2
#define	SB_PROCESS_FLAGS_RESERVE_1MB   0x8
#define	SB_PROCESS_FLAGS_SKIP_CHECKS   0x20

Typedefs
typedef enum _SMSRV_API_NUMBER	SMSRV_API_NUMBER
typedef struct _SM_CREATE_FOREIGN_SESSION_MSG	SM_CREATE_FOREIGN_SESSION_MSG
typedef struct _SM_CREATE_FOREIGN_SESSION_MSG *	PSM_CREATE_FOREIGN_SESSION_MSG
typedef struct _SM_SESSION_COMPLETE_MSG	SM_SESSION_COMPLETE_MSG
typedef struct _SM_SESSION_COMPLETE_MSG *	PSM_SESSION_COMPLETE_MSG
typedef struct _SM_TERMINATE_FOREIGN_SESSION_MSG	SM_TERMINATE_FOREIGN_SESSION_MSG
typedef struct _SM_TERMINATE_FOREIGN_SESSION_MSG *	PSM_TERMINATE_FOREIGN_SESSION_MSG
typedef struct _SM_EXEC_PGM_MSG	SM_EXEC_PGM_MSG
typedef struct _SM_EXEC_PGM_MSG *	PSM_EXEC_PGM_MSG
typedef struct _SM_LOAD_DEFERED_SUBSYSTEM_MSG	SM_LOAD_DEFERED_SUBSYSTEM_MSG
typedef struct _SM_LOAD_DEFERED_SUBSYSTEM_MSG *	PSM_LOAD_DEFERED_SUBSYSTEM_MSG
typedef struct _SM_START_CSR_MSG	SM_START_CSR_MSG
typedef struct _SM_START_CSR_MSG *	PSM_START_CSR_MSG
typedef struct _SM_STOP_CSR_MSG	SM_STOP_CSR_MSG
typedef struct _SM_STOP_CSR_MSG *	PSM_STOP_CSR_MSG
typedef struct _SM_API_MSG	SM_API_MSG
typedef struct _SM_API_MSG *	PSM_API_MSG
typedef enum _SB_API_NUMBER	SB_API_NUMBER
typedef struct _SB_CREATE_SESSION_MSG	SB_CREATE_SESSION_MSG
typedef struct _SB_CREATE_SESSION_MSG *	PSB_CREATE_SESSION_MSG
typedef struct _SB_TERMINATE_SESSION_MSG	SB_TERMINATE_SESSION_MSG
typedef struct _SB_TERMINATE_SESSION_MSG *	PSB_TERMINATE_SESSION_MSG
typedef struct _SB_FOREIGN_SESSION_COMPLETE_MSG	SB_FOREIGN_SESSION_COMPLETE_MSG
typedef struct _SB_FOREIGN_SESSION_COMPLETE_MSG *	PSB_FOREIGN_SESSION_COMPLETE_MSG
typedef struct _SB_CREATE_PROCESS_MSG	SB_CREATE_PROCESS_MSG
typedef struct _SB_CREATE_PROCESS_MSG *	PSB_CREATE_PROCESS_MSG
typedef struct _SB_CONNECTION_INFO	SB_CONNECTION_INFO
typedef struct _SB_CONNECTION_INFO *	PSB_CONNECTION_INFO
typedef struct _SB_API_MSG	SB_API_MSG
typedef struct _SB_API_MSG *	PSB_API_MSG
typedef BOOLEAN(NTAPI *	PSB_API_ROUTINE) (_In_ PSB_API_MSG SbApiMsg)

Enumerations
enum	_SMSRV_API_NUMBER {   SmpCreateForeignSessionApi, SmpSessionCompleteApi, SmpTerminateForeignSessionApi, SmpExecPgmApi,   SmpLoadDeferedSubsystemApi, SmpStartCsrApi, SmpStopCsrApi, SmpMaxApiNumber }
enum	_SB_API_NUMBER {   SbpCreateSession, SbpTerminateSession, SbpForeignSessionComplete, SbpCreateProcess,   SbpMaxApiNumber }

Functions
	C_ASSERT (sizeof(SM_EXEC_PGM_MSG)==0x48)
	C_ASSERT (sizeof(SM_START_CSR_MSG)==0x110)
	C_ASSERT (sizeof(SM_API_MSG)==0x130)
	C_ASSERT (sizeof(SB_CREATE_SESSION_MSG)==0x58)
	C_ASSERT (sizeof(SB_CREATE_PROCESS_MSG)==0x18)
	C_ASSERT (sizeof(SB_API_MSG)==0x110)
NTSTATUS NTAPI	SmConnectToSm (_In_opt_ PUNICODE_STRING SbApiPortName, _In_opt_ HANDLE SbApiPort, _In_opt_ ULONG ImageType, _Out_ PHANDLE SmApiPort)
	Connects to the SM API port for registering a session callback port (Sb) associated to a subsystem, or for issuing API requests to the SM API port. More...
NTSTATUS NTAPI	SmSendMsgToSm (_In_ HANDLE SmApiPort, _Inout_ PSM_API_MSG SmApiMsg)
	Sends a message to the SM via the SM API port. More...
NTSTATUS NTAPI	SmSessionComplete (_In_ HANDLE SmApiPort, _In_ ULONG SessionId, _In_ NTSTATUS SessionStatus)
	This function is called by an environment subsystem server to tell the SM it has terminated the session it managed. More...
NTSTATUS NTAPI	SmExecPgm (_In_ HANDLE SmApiPort, _In_ PRTL_USER_PROCESS_INFORMATION ProcessInformation, _In_ BOOLEAN DebugFlag)
	Requests the SM to start a process under a new environment session. More...
NTSTATUS NTAPI	SmLoadDeferedSubsystem (_In_ HANDLE SmApiPort, _In_ PUNICODE_STRING DeferedSubsystem)
	This function is used to make the SM start an environment subsystem server process. More...
NTSTATUS NTAPI	SmStartCsr (_In_ HANDLE SmApiPort, _Out_ PULONG pMuSessionId, _In_opt_ PUNICODE_STRING CommandLine, _Out_ PHANDLE pWindowsSubSysProcessId, _Out_ PHANDLE pInitialCommandProcessId)
	Requests the SM to create a new Terminal Services session and start an initial command. More...
NTSTATUS NTAPI	SmStopCsr (_In_ HANDLE SmApiPort, _In_ ULONG MuSessionId)
	Requests the SM to terminate a Terminal Services session. More...

Macro Definition Documentation

SB_PROCESS_FLAGS_DEBUG

#define SB_PROCESS_FLAGS_DEBUG   0x1

Definition at line 182 of file smmsg.h.

SB_PROCESS_FLAGS_RESERVE_1MB

#define SB_PROCESS_FLAGS_RESERVE_1MB   0x8

Definition at line 184 of file smmsg.h.

SB_PROCESS_FLAGS_SKIP_CHECKS

#define SB_PROCESS_FLAGS_SKIP_CHECKS   0x20

Definition at line 185 of file smmsg.h.

SB_PROCESS_FLAGS_WAIT_ON_THREAD

#define SB_PROCESS_FLAGS_WAIT_ON_THREAD   0x2

Definition at line 183 of file smmsg.h.

Typedef Documentation

PSB_API_MSG

typedef struct _SB_API_MSG * PSB_API_MSG

PSB_API_ROUTINE

typedef BOOLEAN(NTAPI * PSB_API_ROUTINE) (_In_ PSB_API_MSG SbApiMsg)

Definition at line 265 of file smmsg.h.

PSB_CONNECTION_INFO

typedef struct _SB_CONNECTION_INFO * PSB_CONNECTION_INFO

PSB_CREATE_PROCESS_MSG

typedef struct _SB_CREATE_PROCESS_MSG * PSB_CREATE_PROCESS_MSG

PSB_CREATE_SESSION_MSG

typedef struct _SB_CREATE_SESSION_MSG * PSB_CREATE_SESSION_MSG

PSB_FOREIGN_SESSION_COMPLETE_MSG

typedef struct _SB_FOREIGN_SESSION_COMPLETE_MSG * PSB_FOREIGN_SESSION_COMPLETE_MSG

PSB_TERMINATE_SESSION_MSG

typedef struct _SB_TERMINATE_SESSION_MSG * PSB_TERMINATE_SESSION_MSG

PSM_API_MSG

typedef struct _SM_API_MSG * PSM_API_MSG

PSM_CREATE_FOREIGN_SESSION_MSG

typedef struct _SM_CREATE_FOREIGN_SESSION_MSG * PSM_CREATE_FOREIGN_SESSION_MSG

PSM_EXEC_PGM_MSG

typedef struct _SM_EXEC_PGM_MSG * PSM_EXEC_PGM_MSG

PSM_LOAD_DEFERED_SUBSYSTEM_MSG

typedef struct _SM_LOAD_DEFERED_SUBSYSTEM_MSG * PSM_LOAD_DEFERED_SUBSYSTEM_MSG

PSM_SESSION_COMPLETE_MSG

typedef struct _SM_SESSION_COMPLETE_MSG * PSM_SESSION_COMPLETE_MSG

PSM_START_CSR_MSG

typedef struct _SM_START_CSR_MSG * PSM_START_CSR_MSG

PSM_STOP_CSR_MSG

typedef struct _SM_STOP_CSR_MSG * PSM_STOP_CSR_MSG

PSM_TERMINATE_FOREIGN_SESSION_MSG

typedef struct _SM_TERMINATE_FOREIGN_SESSION_MSG * PSM_TERMINATE_FOREIGN_SESSION_MSG

SB_API_MSG

typedef struct _SB_API_MSG SB_API_MSG

SB_API_NUMBER

typedef enum _SB_API_NUMBER SB_API_NUMBER

SB_CONNECTION_INFO

typedef struct _SB_CONNECTION_INFO SB_CONNECTION_INFO

SB_CREATE_PROCESS_MSG

typedef struct _SB_CREATE_PROCESS_MSG SB_CREATE_PROCESS_MSG

SB_CREATE_SESSION_MSG

typedef struct _SB_CREATE_SESSION_MSG SB_CREATE_SESSION_MSG

SB_FOREIGN_SESSION_COMPLETE_MSG

typedef struct _SB_FOREIGN_SESSION_COMPLETE_MSG SB_FOREIGN_SESSION_COMPLETE_MSG

SB_TERMINATE_SESSION_MSG

typedef struct _SB_TERMINATE_SESSION_MSG SB_TERMINATE_SESSION_MSG

SM_API_MSG

typedef struct _SM_API_MSG SM_API_MSG

SM_CREATE_FOREIGN_SESSION_MSG

typedef struct _SM_CREATE_FOREIGN_SESSION_MSG SM_CREATE_FOREIGN_SESSION_MSG

SM_EXEC_PGM_MSG

typedef struct _SM_EXEC_PGM_MSG SM_EXEC_PGM_MSG

SM_LOAD_DEFERED_SUBSYSTEM_MSG

typedef struct _SM_LOAD_DEFERED_SUBSYSTEM_MSG SM_LOAD_DEFERED_SUBSYSTEM_MSG

SM_SESSION_COMPLETE_MSG

typedef struct _SM_SESSION_COMPLETE_MSG SM_SESSION_COMPLETE_MSG

SM_START_CSR_MSG

typedef struct _SM_START_CSR_MSG SM_START_CSR_MSG

SM_STOP_CSR_MSG

typedef struct _SM_STOP_CSR_MSG SM_STOP_CSR_MSG

SM_TERMINATE_FOREIGN_SESSION_MSG

typedef struct _SM_TERMINATE_FOREIGN_SESSION_MSG SM_TERMINATE_FOREIGN_SESSION_MSG

SMSRV_API_NUMBER

typedef enum _SMSRV_API_NUMBER SMSRV_API_NUMBER

Enumeration Type Documentation

_SB_API_NUMBER

enum _SB_API_NUMBER

Enumerator
SbpCreateSession
SbpTerminateSession
SbpForeignSessionComplete
SbpCreateProcess
SbpMaxApiNumber

Definition at line 144 of file smmsg.h.

{
    SbpCreateSession,
    SbpTerminateSession,
    SbpForeignSessionComplete,
    SbpCreateProcess,

    SbpMaxApiNumber
} SB_API_NUMBER;

_SMSRV_API_NUMBER

enum _SMSRV_API_NUMBER

Enumerator
SmpCreateForeignSessionApi
SmpSessionCompleteApi
SmpTerminateForeignSessionApi
SmpExecPgmApi
SmpLoadDeferedSubsystemApi
SmpStartCsrApi
SmpStopCsrApi
SmpMaxApiNumber

Definition at line 26 of file smmsg.h.

{
    SmpCreateForeignSessionApi,
    SmpSessionCompleteApi,
    SmpTerminateForeignSessionApi,
    SmpExecPgmApi,
    SmpLoadDeferedSubsystemApi,
    SmpStartCsrApi,
    SmpStopCsrApi,

    SmpMaxApiNumber
} SMSRV_API_NUMBER;

Function Documentation

C_ASSERT() [1/6]

C_ASSERT

(

sizeof(SM_EXEC_PGM_MSG)

= =0x48

)

C_ASSERT() [2/6]

C_ASSERT

(

sizeof(SM_START_CSR_MSG)

= =0x110

)

C_ASSERT() [3/6]

C_ASSERT

(

sizeof(SM_API_MSG)

= =0x130

)

C_ASSERT() [4/6]

C_ASSERT

(

sizeof(SB_CREATE_SESSION_MSG)

= =0x58

)

C_ASSERT() [5/6]

C_ASSERT

(

sizeof(SB_CREATE_PROCESS_MSG)

= =0x18

)

C_ASSERT() [6/6]

C_ASSERT

(

sizeof(SB_API_MSG)

= =0x110

)

SmConnectToSm()

NTSTATUS NTAPI SmConnectToSm	(	_In_opt_ PUNICODE_STRING	SbApiPortName,
		_In_opt_ HANDLE	SbApiPort,
		_In_opt_ ULONG	ImageType,
		_Out_ PHANDLE	SmApiPort
	)

Connects to the SM API port for registering a session callback port (Sb) associated to a subsystem, or for issuing API requests to the SM API port.

There are only two ways to call this API: a) subsystems willing to register with SM will use it with full parameters (the function checks them); b) regular SM clients, will set to 0 the 1st, the 2nd, and the 3rd parameters.

Parameters

[in]	SbApiPortName	Name of the Sb port the calling subsystem server already created in the system namespace.
[in]	SbApiPort	LPC port handle (checked, but not used: the subsystem is required to have already created the callback port before it connects to the SM).
[in]	ImageType	A valid IMAGE_SUBSYSTEM_xxx value. PE images having this subsystem value will be handled by the current subsystem.
[out]	SmApiPort	Pointer to a HANDLE, which will be filled with a valid client-side LPC communication port.

Returns

If all three optional values are omitted, an LPC status. STATUS_INVALID_PARAMETER_MIX if PortName is defined and both SbApiPort and ImageType are 0.

Remarks

Exported on Vista+ by NTDLL and called RtlConnectToSm().

Definition at line 57 of file smclient.c.

{
    NTSTATUS Status;
    SECURITY_QUALITY_OF_SERVICE SecurityQos;
    UNICODE_STRING PortName;
    SB_CONNECTION_INFO ConnectInfo = {0};
    ULONG ConnectInfoLength = sizeof(ConnectInfo);

    /* Setup the QoS structure */
    SecurityQos.ImpersonationLevel = SecurityIdentification;
    SecurityQos.ContextTrackingMode = SECURITY_DYNAMIC_TRACKING;
    SecurityQos.EffectiveOnly = TRUE;

    /* Set the SM API port name */
    RtlInitUnicodeString(&PortName, L"\\SmApiPort"); // SM_API_PORT_NAME

    /* Check if this is a client connecting to SMSS, or SMSS to itself */
    if (SbApiPortName)
    {
        /* A client SB port as well as an image type must be present */
        if (!SbApiPort || (ImageType == IMAGE_SUBSYSTEM_UNKNOWN))
            return STATUS_INVALID_PARAMETER_MIX;

        /* Validate SbApiPortName's length */
        if (SbApiPortName->Length >= sizeof(ConnectInfo.SbApiPortName))
            return STATUS_INVALID_PARAMETER;

        /* Copy the client port name, and NULL-terminate it */
        RtlCopyMemory(ConnectInfo.SbApiPortName,
                      SbApiPortName->Buffer,
                      SbApiPortName->Length);
        ConnectInfo.SbApiPortName[SbApiPortName->Length / sizeof(WCHAR)] = UNICODE_NULL;

        /* Save the subsystem type */
        ConnectInfo.SubsystemType = ImageType;
    }
    else
    {
        /* No client port, and the subsystem type is not set */
        ConnectInfo.SbApiPortName[0] = UNICODE_NULL;
        ConnectInfo.SubsystemType = IMAGE_SUBSYSTEM_UNKNOWN;
    }

    /* Connect to SMSS and exchange connection information */
    Status = NtConnectPort(SmApiPort,
                           &PortName,
                           &SecurityQos,
                           NULL,
                           NULL,
                           NULL,
                           &ConnectInfo,
                           &ConnectInfoLength);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("SmConnectToSm: Connect to Sm failed %lx\n", Status);
    }
#if (NTDDI_VERSION < NTDDI_VISTA)
    else
    {
        /* Treat a warning or informational status as success */
        Status = STATUS_SUCCESS;
    }
#endif

    /* Return if the connection was successful or not */
    return Status;
}

Referenced by CsrServerInitialization(), and SmpExecuteInitialCommand().

SmExecPgm()

NTSTATUS NTAPI SmExecPgm	(	_In_ HANDLE	SmApiPort,
		_In_ PRTL_USER_PROCESS_INFORMATION	ProcessInformation,
		_In_ BOOLEAN	DebugFlag
	)

Requests the SM to start a process under a new environment session.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[in]	ProcessInformation	A process description as returned by RtlCreateUserProcess().
[in]	DebugFlag	If set, indicates that the caller wants to debug this process and act as its debug user interface.

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Definition at line 265 of file smclient.c.

{
    NTSTATUS Status;
    SM_API_MSG SmApiMsg = {0};
    PSM_EXEC_PGM_MSG ExecPgm = &SmApiMsg.u.ExecPgm;

#if 0 //def _WIN64
    /* 64-bit SMSS needs to talk to 32-bit processes so do the LPC conversion */
    if (SmpIsWow64Process())
    {
        return SmpWow64ExecPgm(SmApiPort, ProcessInformation, DebugFlag);
    }
#endif

    /* Set the message data */
    ExecPgm->ProcessInformation = *ProcessInformation;
    ExecPgm->DebugFlag = DebugFlag;

    /* Send the message and wait for a reply */
    SmApiMsg.ApiNumber = SmpExecPgmApi;
    Status = SmSendMsgToSm(SmApiPort, &SmApiMsg);

    /* Close the handles that the parent passed in and return status */
    NtClose(ProcessInformation->ProcessHandle);
    NtClose(ProcessInformation->ThreadHandle);
    return Status;
}

Referenced by SmExecuteProgram(), SmpExecPgm(), and SmpExecuteInitialCommand().

SmLoadDeferedSubsystem()

NTSTATUS NTAPI SmLoadDeferedSubsystem	(	_In_ HANDLE	SmApiPort,
		_In_ PUNICODE_STRING	DeferedSubsystem
	)

This function is used to make the SM start an environment subsystem server process.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[in]	DeferedSubsystem	Name of the subsystem to start. This must be one of the subsystems listed by value's name in the SM registry key \Registry\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems (used by the SM to lookup the corresponding image name). Default valid names are: "Debug", "Windows", "Posix", "Os2".

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Definition at line 317 of file smclient.c.

{
    SM_API_MSG SmApiMsg = {0};
    PSM_LOAD_DEFERED_SUBSYSTEM_MSG LoadDefered = &SmApiMsg.u.LoadDefered;

#if 0 //def _WIN64
    /* 64-bit SMSS needs to talk to 32-bit processes so do the LPC conversion */
    if (SmpIsWow64Process())
    {
        return SmpWow64LoadDeferedSubsystem(SmApiPort, DeferedSubsystem);
    }
#endif

    /* Validate DeferedSubsystem's length */
    if (DeferedSubsystem->Length > sizeof(LoadDefered->Buffer))
        return STATUS_INVALID_PARAMETER;

    /* Set the message data */
    /* Buffer stores a counted non-NULL-terminated UNICODE string */
    LoadDefered->Length = DeferedSubsystem->Length;
    RtlCopyMemory(LoadDefered->Buffer,
                  DeferedSubsystem->Buffer,
                  DeferedSubsystem->Length);

    /* Send the message and wait for a reply */
    SmApiMsg.ApiNumber = SmpLoadDeferedSubsystemApi;
    return SmSendMsgToSm(SmApiPort, &SmApiMsg);
}

SmSendMsgToSm()

NTSTATUS NTAPI SmSendMsgToSm	(	_In_ HANDLE	SmApiPort,
		_Inout_ PSM_API_MSG	SmApiMsg
	)

Sends a message to the SM via the SM API port.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[in,out]	SmApiMsg	Message to send to the SM. The API-specific data must be initialized, and the SmApiMsg->ApiNumber must be specified accordingly.

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Remarks

Exported on Vista+ by NTDLL and called RtlSendMsgToSm().

Definition at line 149 of file smclient.c.

{
    static ULONG RtlpSmMessageInfo[SmpMaxApiNumber] =
    {
        0 /*sizeof(SM_CREATE_FOREIGN_SESSION_MSG)*/,
        sizeof(SM_SESSION_COMPLETE_MSG),
        0 /*sizeof(SM_TERMINATE_FOREIGN_SESSION_MSG)*/,
        sizeof(SM_EXEC_PGM_MSG),
        sizeof(SM_LOAD_DEFERED_SUBSYSTEM_MSG),
        sizeof(SM_START_CSR_MSG),
        sizeof(SM_STOP_CSR_MSG),
    };

    NTSTATUS Status;
    ULONG DataLength;

    if (SmApiMsg->ApiNumber >= SmpMaxApiNumber)
        return STATUS_NOT_IMPLEMENTED;

    /* Obtain the necessary data length for this API */
    DataLength = RtlpSmMessageInfo[SmApiMsg->ApiNumber];

    /* Fill out the Port Message Header */
    // RtlZeroMemory(&SmApiMsg->h, sizeof(SmApiMsg->h));
    SmApiMsg->h.u2.ZeroInit = 0;
    /* DataLength = user_data_size + anything between
     * header and data, including intermediate padding */
    SmApiMsg->h.u1.s1.DataLength = (CSHORT)DataLength +
        FIELD_OFFSET(SM_API_MSG, u) - sizeof(SmApiMsg->h);
    /* TotalLength = sizeof(*SmApiMsg) on <= NT5.2, otherwise:
     * DataLength + header_size == user_data_size + FIELD_OFFSET(SM_API_MSG, u)
     * without structure trailing padding */
    SmApiMsg->h.u1.s1.TotalLength = SmApiMsg->h.u1.s1.DataLength + sizeof(SmApiMsg->h);

    /* Send the LPC message and wait for a reply */
    Status = NtRequestWaitReplyPort(SmApiPort, &SmApiMsg->h, &SmApiMsg->h);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("SmSendMsgToSm: NtRequestWaitReplyPort failed, Status: 0x%08lx\n", Status);
    }
    else
    {
        /* Return the real status */
        Status = SmApiMsg->ReturnValue;
    }

    return Status;
}

Referenced by SmExecPgm(), SmLoadDeferedSubsystem(), SmSessionComplete(), SmStartCsr(), and SmStopCsr().

SmSessionComplete()

NTSTATUS NTAPI SmSessionComplete	(	_In_ HANDLE	SmApiPort,
		_In_ ULONG	SessionId,
		_In_ NTSTATUS	SessionStatus
	)

This function is called by an environment subsystem server to tell the SM it has terminated the session it managed.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[in]	SessionId	The session ID of the session being terminated.
[in]	SessionStatus	An NT status code for the termination.

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Definition at line 220 of file smclient.c.

{
    SM_API_MSG SmApiMsg = {0};
    PSM_SESSION_COMPLETE_MSG SessionComplete = &SmApiMsg.u.SessionComplete;

#if 0 //def _WIN64
    /* 64-bit SMSS needs to talk to 32-bit processes so do the LPC conversion */
    if (SmpIsWow64Process())
    {
        return SmpWow64SessionComplete(SmApiPort, SessionId, SessionStatus);
    }
#endif

    /* Set the message data */
    SessionComplete->SessionId = SessionId;
    SessionComplete->SessionStatus = SessionStatus;

    /* Send the message and wait for a reply */
    SmApiMsg.ApiNumber = SmpSessionCompleteApi;
    return SmSendMsgToSm(SmApiPort, &SmApiMsg);
}

Referenced by CsrDereferenceNtSession().

SmStartCsr()

NTSTATUS NTAPI SmStartCsr	(	_In_ HANDLE	SmApiPort,
		_Out_ PULONG	pMuSessionId,
		_In_opt_ PUNICODE_STRING	CommandLine,
		_Out_ PHANDLE	pWindowsSubSysProcessId,
		_Out_ PHANDLE	pInitialCommandProcessId
	)

Requests the SM to create a new Terminal Services session and start an initial command.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[out]	pMuSessionId	Pointer to a variable that receives the session ID of the new Terminal Services session that has been created.
[in]	CommandLine	Full path to the image to be used as the initial command.
[out]	pWindowsSubSysProcessId	Pointer to a variable that receives the process ID of the environment subsystem that has been started in the new session.
[out]	pInitialCommandProcessId	Pointer to a variable that receives the process ID of the initial command.

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Definition at line 376 of file smclient.c.

{
    NTSTATUS Status;
    SM_API_MSG SmApiMsg = {0};
    PSM_START_CSR_MSG StartCsr = &SmApiMsg.u.StartCsr;

#if 0 //def _WIN64
    /* 64-bit SMSS needs to talk to 32-bit processes so do the LPC conversion */
    if (SmpIsWow64Process())
    {
        return SmpWow64StartCsr(SmApiPort,
                                pMuSessionId,
                                CommandLine,
                                pWindowsSubSysProcessId,
                                pInitialCommandProcessId);
    }
#endif

    /* Set the message data */
    if (CommandLine)
    {
        /* Validate CommandLine's length */
        if (CommandLine->Length > sizeof(StartCsr->Buffer))
            return STATUS_INVALID_PARAMETER;

        /* Buffer stores a counted non-NULL-terminated UNICODE string */
        StartCsr->Length = CommandLine->Length;
        RtlCopyMemory(StartCsr->Buffer,
                      CommandLine->Buffer,
                      CommandLine->Length);
    }
    else
    {
        StartCsr->Length = 0;
    }

    /* Send the message and wait for a reply */
    SmApiMsg.ApiNumber = SmpStartCsrApi;
    Status = SmSendMsgToSm(SmApiPort, &SmApiMsg);

    /* Give back information to caller */
    *pMuSessionId = StartCsr->MuSessionId;
    *pWindowsSubSysProcessId = StartCsr->WindowsSubSysProcessId;
    *pInitialCommandProcessId = StartCsr->SmpInitialCommandProcessId;

    return Status;
}

Referenced by SmpStartCsr().

SmStopCsr()

NTSTATUS NTAPI SmStopCsr	(	_In_ HANDLE	SmApiPort,
		_In_ ULONG	MuSessionId
	)

Requests the SM to terminate a Terminal Services session.

Parameters

[in]	SmApiPort	Port handle returned by SmConnectToSm().
[in]	MuSessionId	The Terminal Services session ID, returned by SmStartCsr().

Returns

Success status as handed by the SM reply; otherwise a failure status code.

Definition at line 445 of file smclient.c.

{
    SM_API_MSG SmApiMsg = {0};

#if 0 //def _WIN64
    /* 64-bit SMSS needs to talk to 32-bit processes so do the LPC conversion */
    if (SmpIsWow64Process())
    {
        return SmpWow64StopCsr(SmApiPort, MuSessionId);
    }
#endif

    /* Set the message data */
    SmApiMsg.u.StopCsr.MuSessionId = MuSessionId;

    /* Send the message and wait for a reply */
    SmApiMsg.ApiNumber = SmpStopCsrApi;
    return SmSendMsgToSm(SmApiPort, &SmApiMsg);
}