Share via


RasValidateEntryName

This function validates the format of a connection entry name. It must contain at least one non-white-space alpha-numeric character.

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.

Include Raserror.h for definitions of the RAS error codes.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Ras.h.
Link Library: Coredll.lib.

See Also

RasGetEntryProperties

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.