### IInvalidName

  Provides an exception message reporting that an invalid name was given for an object. IInvalidName provides an exception reporting that an invalid name, such as a file name or a network resource name, was used for an object. You can use the standard error message the class provides when you throw an exception under these circumstances or you can construct an instance of IInvalidName that allows you to specify a custom message.

### IInvalidName - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class. You cannot assign one IInvalidName object from another.

~IInvalidName
  Destructor.

      public:
      virtual ~IInvalidName()

  This function destroys an IInvalidName exception object.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

IInvalidName

  You can create objects of this class by doing the following:

  - Using the constructor where you specify the error text.
  - Using the macros discussed in IException. The Open Class Library provides these macros to make creating exceptions easier for you.

  You can also copy an instance of this exception class.

  Overload 1
  Constructs an IInvalidName exception using a custom error message, if one is provided.

      public:
      IInvalidName(const char* text = 0)

  Use this function to create an invalid name exception that provides a custom message giving specific details of the error condition.

  text
    The error message to use for this exception. If you do not provide an error message, a default message is used.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2
  Copy constructor.

      public:
      IInvalidName(const IInvalidName&)

  The copy constructor is provided so that the compiler can make copies of the object during the throwing of an exception.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Exception Type

Use the function in this group to obtain the name of the exception.

name
  Returns the name of the exception.

      public:
      virtual const char* name() const

  Returns the name of the actual exception class.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### IInvalidName - Inherited Member Functions and Data

#### Inherited Public Functions

  IException

  -     virtual ~IException()

  -     virtual IException&
          addLocation( const IExceptionLocation& location )

  -     IException& appendText(const char* errorText)

  -     static void
          assertParameter( const char* exceptionText,
                           IExceptionLocation location )

  -     ErrorCodeGroup errorCodeGroup() const

  -     unsigned long errorId() const

  -     IException( const char* errorText,
                    unsigned long errorId = 0,
                    Severity severity = IException::unrecoverable )

  -     IException(const IException& exception)

  -     virtual int isRecoverable() const

  -     const IExceptionLocation*
          locationAtIndex( unsigned long locationIndex ) const

  -     unsigned long locationCount() const

  -     virtual IException& logExceptionData()

  -     IException& setErrorCodeGroup(ErrorCodeGroup errorGroup)

  -     IException& setErrorId(unsigned long errorId)

  -     IException& setSeverity(Severity severity)

  -     IException& setText(const char* errorText)

  -     static IException::TraceFn*
          setTraceFunction( IException::TraceFn& traceFunction )

  -     virtual void terminate()

  -     const char* text(unsigned long indexFromTop = 0) const

  -     unsigned long textCount() const

  IInvalidRequest

  -     virtual ~IInvalidRequest()

  -     IInvalidRequest( const char* errorText,
                         unsigned long errorId = 0,
                         Severity severity = IException::unrecoverable )

  -     IInvalidRequest(const IInvalidRequest& exception)

#### Inherited Public Data

  IException

  -     static ErrorCodeGroup const baseLibrary

  -     static ErrorCodeGroup const CLibrary

  -     static ErrorCodeGroup const operatingSystem

  -     static ErrorCodeGroup const other

  -     static ErrorCodeGroup const presentationSystem

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None