3.7.4.1.30 RpcWinStationIsHelpAssistantSession (Opnum 61)

  • Article

The RpcWinStationIsHelpAssistantSession method determines if a session is created by the built-in HelpAssistant user account.<207> The caller is not required to have any specific permission to call this method.

 BOOLEAN RpcWinStationIsHelpAssistantSession(
   [in] SERVER_HANDLE hServer,
   [out] DWORD* pResult,
   [in] ULONG SessionId
 );

hServer: Handle to the server object. This is of type SERVER_HANDLE. The hServer argument MUST be obtained from a previous call to RpcWinStationOpenServer.

pResult:  Failure error code if the call to RpcWinStationIsHelpAssistantSession failed. If no error was encountered while executing the call, this parameter MUST be STATUS_SUCCESS (0x00000000).

Value

Meaning

STATUS_SUCCESS

0x00000000

The call was executed successfully.

STATUS_UNSUCCESSFUL

0xC0000001

Execution of the call failed.

STATUS_CTX_WINSTATION_NOT_FOUND

0xC00A0015

The SessionId does not exist.

STATUS_WRONG_PASSWORD

0xC000006A

This is a Help Assistant session but the help assistance ticket associated with the session is no longer valid.

SessionId: The ID of the session to check.

Return Values:  Returns TRUE if the session is running as HelpAssistant, and FALSE if this is not a HelpAssistant session or if an error was encountered during the test. On failure, pResult indicates the failure status code.

Return value/code

Description

0x01

TRUE

Successful completion.

0x00

FALSE

Method call failed.