PA_DetachResource


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

PA_GetResourceHandle .

Error Handling

Use PA_GetLastError to see if an error occurred