|
|
|
|
version 2003
PA_GetResourceName (resFile; kind; resID; name)
| Parameter | Type | Description | |
| resFile | short | → | File reference number of the file to access |
| kind | unsigned long | → | Kind (4 Bytes type) of resource to access |
| resID | short | → | Unique resource ID |
| name | char* | ← | Resource name |
Description
The routine
PA_GetResourceName
returns in the string buffer
name
the name of the resource of type
kind
and the unique ID
resID
in the file referenced by
resFile
.
Depending on default settings or on previous calls to
PA_UsePStrings
or
PA_UseCStrings
,
name
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 sets
name
to an empty string and
PA_GetLastError
returns -5 ("Resource not found").
Example
Getting information on a resource:
short GetSomeResInfo(short resFile, unsigned long kind, short ID, long *size, char *name)
{
if(size)
*size = PA_getresourceSize(resFile, kind, ID);
if(name)
PA_GetResourceName(resFile, kind, ID, name);
return PA_GetLastError();
}
See Also
PA_GetResourceIDList , PA_GetResourceNameList , PA_SetResourceName .
Error Handling
Use
PA_GetLastError
to see if an error occurred.