3.3.4.1.1 GetNoviceUserInfo (Opnum 7)

The GetNoviceUserInfo method is received by the server in an RPC_REQUEST packet. The method is received in the terminal services session as specified by the Client. In response, the server returns the Remote Assistance Connection String 2 for the specified terminal services session.

 [id(1), helpstring("method GetNoviceUserInfo")] HRESULT GetNoviceUserInfo(
   [in, out] LPWSTR* szName
 );

szName: A pointer to a NULL-terminated Unicode string that contains the Remote Assistance Connection String 2 for the specified terminal services session.

Return Values: A signed 32-bit value indicating return status. This method MUST return zero to indicate success, or an HRESULT error value (as specified in [MS-ERREF] section 2.1.1) to indicate failure.

Return value/code

Description

0x00000000

S_OK

 The call was successful.

0x80004003

E_POINTER

 The method failed due to an invalid pointer for szName.

0x8007000E

E_OUTOFMEMORY

 Out of memory.

0x80070052

ERROR_CANNOT_MAKE

An instance of Remote Assistance is already running on the novice's machine.

Exceptions Thrown:

No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].