PA_Get4DPreferencesFilename


version 2003


PA_Get4DPreferencesFilename (prefsName)

Parameter Type Description
prefsName char * Pointer to a char buffer
Name of the 4D Preferences file

Description

The routine PA_Get4DPreferencesFilename fills the string pointed to by prefName with the name of the 4th Dimension preference file name (located in the 4D Folder).

NOTE

prefName

can contain up to 255 characters.

Be sure to leave enough room for the path. It is a good habit to always use 255 length strings (declared as Str255 under MacOS or char[256] under Windows).

WARNING

Modifying the 4th Dimension preferences file is not recommended. A plug-in should create and use its own preferences file.

Example

Get the full path of the 4D preferences file.

   void Get4DPrefsFullPath
   {
      char folder[256], pref[256];
      PA_Get4Dfolder( folder );
      PA_Get4DPreferencesFilename( pref );
      strcat( folder, pref );
   }

See Also

PA_Close4DPreferences , PA_Open4DPreferencesMacResFile .

Error Handling

PA_GetLastError

always returns eER_NoErr