OSDynLoad_GetModuleName

Syntax

#include <cafe/os/OSDynLoad.h>

int OSDynLoad_GetModuleName(OSDynLoad_ModuleHandle aModuleHandle, 
                            char *                 apRetBuffer, 
                            int *                  apBufferSize);

Parameters

aModuleHandle Handle to the module to retrieve the name of.
apRetBuffer Target buffer for the module name. May be NULL.
apBufferSize Input/output parameter of the size of the buffer used. If apRetBuffer is NULL, this argument cannot be NULL.

Return Values

Returns an OSDYNLOAD_ERR_xxx error code (see OSDynLoad.h).

Description

This function can be used to get the name of a loaded RPL module.

To get the name of the main program RPL, use the handle value MAINPROGRAM_MODULE_HANDLE.

If apRetBuffer is NULL, then only the required size of the buffer to be used is returned in the apBufferSize argument.

Do Not Call From

None.

See Also

OSDynLoad_Acquire
OSDynLoad_AddNotifyCallback
OSDynLoad_DelNotifyCallback
OSDynLoad_FindExport
OSDynLoad_FindTag
OSDynLoad_GetAllocator
OSDynLoad_IsModuleLoaded
OSDynLoad_Release
OSDynLoad_SetAllocator

Revision History

2013-11-01 Added OSDynLoad_IsModuleLoaded.
2013-05-08 Automated cleanup pass.
2011-03-11 Initial version.


CONFIDENTIAL