Share via


RasValidateEntryName (Compact 2013)

3/26/2014

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 Compact, 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

Header

ras.h

Library

coredll.lib

See Also

Reference

RAS Functions
RasGetEntryProperties