RasValidateEntryName

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

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

See Also

Reference

RasGetEntryProperties