tfInterfaceName

Jump to: navigation, search
int tfInterfaceName (
ttUserInterface interfaceHandle,
ttUserCharPtr namePtr,
int nameLen
);


Function Description

This function associates a name with an interface.


Parameters

  • interfaceHandle
    The interface handle.
  • namePtr
    The caller-allocated name.
  • nameLen
    The length of the caller-allocated namePtr.


Returns

  • TM_ENOERROR
    Success
  • TM_EINVAL
    Failure: The interfaceHandle or nameLen parameter is invalid.


Usage

This function is used to associated a character-based name with an interface. Use tfInterfaceNameToDevice(…) to retrieve the interface by name. For details on Strong End System Model see Appendix C: Strong End System Model / Weak End System Model.