version 2003
PA_RemoveResourceByName (resfile; kind; resName)
Parameter | Type | Description | |
resfile | short | File reference number of the file to access | |
kind | unsigned long | Kind (4 Bytes type) of resource to access | |
resName | char* | Name of resource to delete |
Description
The routine PA_RemoveResourceByName removes the resource name resName of type kind from the file referenced by resFile.
If the resource does not exist or if resFile is an invalid file reference number, the routine does nothing and sets PA_GetLastError to -3.
If more than one resource in the file has the name resName, the routine removes the first one it finds. Note that the removed resource is not necessarily the oldest.
Depending on default settings or on previous calls to PA_UsePStrings or PA_UseCStrings, resName will be a Pascal or an ANSI C string.
Example
Remove personal resource named "MySuperResource".
#define kMyResourceKind 'PERS' /* . . . */ PA_RemoveResourceByID(resFile, kMyResourceKind, "MySuperResource");
See Also
Error Handling
Use PA_GetLastError to see if an error occurred