RasValidateEntryName
A version of this page is also available for
4/8/2010
This function validates the format of a connection entry name. It must contain at least one non-white-space alpha-numeric character.
Syntax
DWORD RasValidateEntryName(
LPWSTR lpszPhonebook,
LPWSTR lpszEntry
);
Parameters
- lpszPhonebook
This parameter is ignored and should be set to NULL. Phone-book entries are stored in the registry rather than in a phone-book file.
lpszEntry
Pointer to a null-terminated string that contains an entry name. For Windows Embedded CE, the entry name must include at least one alphanumeric character and be a valid registry key name. The entry name cannot begin with a backslash ("\").Character Description |
vertical bar
>
greater than symbol
<
less than symbol
?
question mark
*
asterisk
\
backward slash
/
forward slash
:
colon
Note
The entry name must begin with a backquote (`) to appear in the ActiveSync user interface.
Return Value
Zero indicates success. ERROR_INVALID_NAME or ERROR_ALREADY_EXISTS indicates failure.
Include Raserror.h for definitions of the RAS error codes.
Requirements
| Header | ras.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |