version 2003
PA_DetachResource (resFile; resourceHandle)
Parameter | Type | Description | |
resFile | short | File reference number of the file to access | |
resourceHandle | PA_Handle | Resource handle to detach |
Description
The routine PA_DetachResource tells the Internal Resource Manager that the resource data referenced by resHandle (from file resFile) is no longer a resource; thus, the plug-in can use it like a regular PA_Handle (PA_DisposeHandle, PA_SetHandleSize).
If the resource does not exist or if resFile is an invalid file reference number, the routine leaves the data pointed to by resData unchanged, returns 0L, and PA_GetLastError returns -5 ("Resource not found").
Example
Load a resource handle, and use it as a regular handle.
PA_Handle h; h = PA_GetResourceHandle(resFile, 'TiTi', 128); if(h) { PA_DetachResource(resFile, h); if(PA_GetLastError() ==eER_NoErr) { /* OK, h points now to a "regular" data, we can use it as we want */ . . . . . . PA_DisposeHandle(h); } }
See Also
Error Handling
Use PA_GetLastError to see if an error occurred