version 2003
PA_SetResourceName (resFile; kind; resID; newName)
Parameter | Type | Description | |
resFile | short | File reference number of the file to access | |
kind | unsigned long | Kind (4 Bytes type) of resource to acces | |
resID | short | Unique resource ID | |
newName | char* | New name of the resource |
Description
The routine PA_SetResourceName changes the name of the resource of type kind and the unique ID resID in the file referenced by resFile to newName.
Depending on default settings or on previous calls to PA_UsePStrings or PA_UseCStrings, newName will be a Pascal or an ANSI C string.
If the resource does not exist or if resFile is an invalid file reference number, the routine does nothing, and PA_GetLastError returns -5 ("Resource not found").
Example
Changing the name of resource 'toto' ID 128.
PA_SetResourceName(resFile, 'toto', 128, "\pThe toto resource"); // using Pascal strings under MacOS
See Also
PA_GetResourceName, PA_GetResourceNameList.
Error Handling
Use PA_GetLastError to see if an error occurred