This function validates the format of a connection entry name. It must that contains at least one non-white-space alpha-numeric character.
At a Glance
| Header file: | Ras.h |
| Windows CE versions: | 1.0 and later |
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 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 |
Return Values
Zero indicates success. ERROR_INVALID_NAME or ERROR_ALREADY_EXISTS indicates failure.
See Also