LInet::GetPrevItem
#include "ltwrappr.h"
LInet * LInet::GetPrevItem(plRemoteComp, bByType=FALSE)
LInet * plRemoteComp; |
/* instance of a remote computer */ |
L_BOOL bByType; |
/* flag that indicates the previous item to get */ |
Retrieves the previous remote computer in the connection list, based on the specified parameters.
Parameter |
Description | |
plRemoteComp |
Instance of the remote computer currently referenced in the connection list. | |
bByType |
Flag that indicates the next item to get. Possible values are: | |
|
Value |
Meaning |
|
TRUE |
Get the previous remote computer in the internal connection list that has the same type (server or client) as plRemoteComp. |
|
FALSE |
Get the previous remote computer in the internal connection list, regardless of type. |
Returns
A pointer to an LInet object that references the previous remote computer.
Comments
If bByType = FALSE, this function will get the previous remote computer in the internal connection list, either SERVER or CLIENT.
If bByType = TRUE, this function will get the previous remote computer in the internal connection list that has the same type as plRemoteComp.
Do not delete plRemoteComp.
Required DLLs and Libraries
LTNET For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Functions: |
LInet::ExistsItem, LInet::GetItem, LInet::GetFirstItem, LInet::GetLastItem, LInet::GetNextItem, LInet::GetItemsCount, Class Members |
Example
// a user defined class derived from LInet should be used to support the OnConnect callback functions // suppose it was named as LUserInetGPI class LUserInetGPI : public LInet { protected: virtual L_INT OnConnect(LInet *plConnection, L_INT nError); }; L_INT LInet__GetPrevItemExample() { L_INT nRet; LUserInetGPI UserInet; // other operations // connect to LEAD nRet = UserInet.Connect("207.238.49.190", 1000); if(nRet != SUCCESS) return nRet; return SUCCESS; } L_INT LUserInetGPI::OnConnect(LInet *plConnection, L_INT nError) { UNREFERENCED_PARAMETER(nError); LInet* plRemote = NULL; L_CHAR* pName; L_TCHAR szString[256]; plRemote = GetPrevItem(plConnection); if (plRemote != NULL) { pName = plRemote->GetHostName(); wsprintf(szString, TEXT("Host name for pervious connection: %s"), pName); MessageBox(NULL, szString, TEXT(""), MB_OK); } return SUCCESS; }