RasSetEntryDevConfig
The RasSetEntryDevConfig function saves the device information used with a RAS entry.
Syntax
DWORD RasSetEntryDevConfig(LPCTSTR lpszPhoneBook, LPCTSTR szEntry, DWORD dwDeviceID, LPVARSTRING lpDeviceConfig);
At a Glance
| Header file: |
Afdfunc.h |
| Module: |
Ras |
| Platforms: |
H/PC |
| Windows CE versions: |
1.0 and later |
Parameters
- lpszPhoneBook
- This parameter is ignored and should always be NULL because the phone book entries are stored in the registry.
- szEntry
- Pointer to a null-terminated string containing an existing entry name.
- dwDeviceID
- The TAPI device identifier to save.
- lpDeviceConfig
- Pointer to the memory location of the type VARSTRING of the device configuration structure. Prior to calling RasSetEntryDevConfig, the application should set the dwNeededSize member of this structure to indicate the amount of memory required for the information. This parameter can be NULL if the default device configuration for the device is to be used.
Return Values
If the function succeeds, the return value is zero. If the function fails, the return value will be one of the following:
- ERROR_CANNOT_OPEN_PHONEBOOK
- Invalid phone book.
- ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
- Invalid szEntry.
- ERROR_INVALID_PARAMETER
- Invalid lpDeviceConfig parameter.
Remarks
In Windows CE version 2.0, the RasSetEntryProperty function supports the same functionality as the RasSetEntryDevConfig function. An application should use the RasSetEntryProperties function to set device information.
See Also
VARSTRING, RasGetEntryDevConfig