RasValidateEntryName (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

RAS Functions
RasGetEntryProperties