tfInterfaceName

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.