PA_DetachResource

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_DetachResource (resFile; resourceHandle)

ParameterTypeDescription
resFileshortFile reference number of the file to access
resourceHandlePA_HandleResource 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


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next