3.5.4.1.7 RpcGetSessionProtocolLastInputTime (Opnum 9)

The RpcGetSessionProtocolLastInputTime method returns the protocol status and the time the last input was received by the protocol associated with a specific session running on a terminal server. The caller MUST have WINSTATION_QUERY permission for the session. The method checks whether the caller has WINSTATION_QUERY permission (section 3.1.1) by setting it as the Access Request mask, and fails if the caller does not have the permission.

 HRESULT RpcGetSessionProtocolLastInputTime(
   [in] handle_t hBinding,
   [in] ULONG SessionId,
   [in] PROTOCOLSTATUS_INFO_TYPE InfoType,
   [out, size_is(,*pcbProtoStatus )] 
     unsigned char** ppProtoStatus,
   [out] ULONG* pcbProtoStatus,
   [out] hyper* pLastInputTime
 );

hBinding:  The RPC binding handle. For more information, see [MSDN-RPCBIND].

SessionId:  The ID of the session from which information is to be retrieved.

InfoType:  Specifies what type of information to gather. This is of type PROTOCOLSTATUS_INFO_TYPE.

ppProtoStatus:  The buffer that contains protocol status data. This data is of type PROTOCOLSTATUS, specified in section 2.2.2.20.1.

pcbProtoStatus:  The number of bytes of protocol data returned.

pLastInputTime:  The time the last input was received by the server.

Time is measured as the number of 100-nanosecond intervals since January 1, 1601 (UTC).

Return Values: The method MUST return S_OK (0x00000000) on success; otherwise, it MUST return an implementation-specific negative value.

Return value/code	Description
0x00000000 S_OK	Successful completion