OSDynLoad_FindTag

Syntax

#include <cafe/os/OSDynLoad.h>

int OSDynLoad_FindTag(OSDynLoad_ModuleHandle aModuleHandle, 
                      char const *           apTag, 
                      char *                 apRetBuffer, 
                      int *                  apBufferSize);

Parameters

aModuleHandle	Handle of the loaded module holding the tag you want to find.
apTag	String of the tag name to find. May not be `NULL`.
apRetBuffer	Pointer to the buffer space to hold tag value. May be `NULL`.
apBufferSize	Pointer to the buffer size on input. Receives the number of characters in value on output. May not be `NULL`.

Return Values

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

Description

Finds a tag attached to an RPL at the MakeRPL stage.

A tag is not a code or data symbol, and cannot be used in code or data. A tag typically holds prepackaging or versioning information. For more information, see makerpl[32|64].

Do Not Call From

None.

Revision History

2013/11/01 Added OSDynLoad_IsModuleLoaded.
2013/05/08 Automated cleanup pass.
2012/08/01 Cleanup Pass.
2011/03/11 Initial version.

CONFIDENTIAL