CUT_RAS::GetEntry
int GetEntry(LPRASENTRYNAME ren,DWORD index)
Parameters
|
ren |
A pointer to an existing RASENTRYNAME structure. |
|
index |
A zero-based index (0 to (GetEntryCount()-1) ). Determines the entry from which to retrieve information. |
Return Value
|
UTE_SUCCESS |
Operation completed successfully. |
|
UTE_ERROR |
Operation failed and there is no data to be returned. |
|
UTE_INDEX_OUTOFRANGE |
The supplied index does not point to a valid phonebook entry. |
|
UTE_RAS_LOAD_ERROR |
Unable to load the RAS DLLs. |
Remarks
Call this function to fill in the given RASENTRYNAME structure with the phonebook entry's name.
See also: EnumEntries | GetEntryCount
Example
// stores the first phonebook entry's name to a RASENTRYNAME structure
LPRASENTRYNAME ren = new RASENTRYNAME [sizeof(RASENTRYNAME)+1];
// get the first phonebook entry
ras.EnumEntries();
memset(ren,0,sizeof(RASENTRYNAME));
ras.GetEntry (ren,0);
delete [] ren;