RasGetSubEntryHandle info  Overview  Group

The RasGetSubEntryHandle function retrieves a connection handle for a specified subentry of a multilink connection.

DWORD RasGetSubEntryHandle(

Parameters

hrasconn

Specifies an HRASCONN connection handle returned by the RasDial function for a multilink phone-book entry.

dwSubEntry

Specifies a valid subentry index for the phone-book entry.

lphrasconn

Pointer to an HRASCONN variable that receives a connection handle that represents the subentry connection.

Return Values

If the function succeeds, the return value is zero.

If the function fails, the return value can be one of the following error codes.

Remarks

The connection handle specified in the hrasconn parameter refers to the entire multilink connection, but the connection handle returned in the *lphrasconn parameter refers only to the subentry connection. You can use the subentry connection handle in any function that accepts an hrasconn parameter, including the RasHangUp, RasGetConnectStatus, and RasGetProjectionInfo functions. The projection information returned by RasGetProjectionInfo for a multilink entry is the same for the each of the subentry connection handles as it is for the main connection handle.

See Also

RasDial, RasGetConnectStatus, RasGetProjectionInfo, RasHangUp

  .