Share via

3.9.4.1.1 RpcGetSessionIP (Opnum 0)

  • Article

The RpcGetSessionIP method retrieves the IP address assigned to the session. This MUST be called by an administrator or the same user who logged onto the session.<212> The method performs access checks as defined in section 3.1.3 and 3.1.4. The method fails if both checks fail.

 HRESULT RpcGetSessionIP(
   [in] handle_t hBinding,
   [in] USHORT Family,
   [in] DWORD SessionId,
   [ref, out] TSVIPSession* ppVIPSession
 );

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

Family: MUST be AF_INET.

SessionId: The identifier of the session to open. This session MUST be present on the terminal server. This MUST NOT be the session ID of any of the listener sessions.

ppVIPSession: The session structure containing the IP address assigned to the session. This is of type TSVIPSession.

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.