This method is deprecated.
Retrieves the string for a named resource in a resource file. Names for a resource can be given as a variable set of null terminated string arguments. Each string specifies one or more levels in the naming tree. A simple string without '.' characters specifies a single level in the naming tree where as a dot separated set of names in a string specify a series of names in the naming tree. The final argument must be 0 to indicate the end of the name list.
Finding a size of named string can be done by passing -1 as the buffer argument, as follows:
IRESFILE_GetNamedString(piResFile, (AECHAR*)-1, &len, "Main", "Dialog", "Title", 0))
After allocating the buffer, a future call would retrieve the actual string:
IRESFILE_GetNamedString(piResFile, pBuf, &len, "Main", "Dialog", "Title", 0))
If successful, the number of bytes copied with be stored in len.
- po:A pointer to an IResFile object.
- buf:Pointer to a storage area for the located string
- plen:Pointer to size of resource or input buffer
int IRESFILE_GetNamedString(IResFile *po, AECHAR *buf, uint32 *plen, ...)