AddMapInitListener

ISettlers4Api::AddMapInitListener method

Registers a map initialization listener whose callback will be called whenever a map is being loaded by the game. It can be used to initialize your application for a new game.

Syntax

S4HOOK ISettlers4Api::AddMapInitListener(
	LPS4MAPINITCALLBACK lpCallback
);

Parameters

lpCallback

A function pointer to the callback function. This must not be NULL. See S4MapInitProc for implementation details of this procedure.

Return value

If the registration of the callback failed NULL is returned.

If the method succeeds it will returns a S4HOOK handle. Pass the S4HOOK to the ISettlers4Api::RemoveListener method to remove the callback from the chain when you do not need it anymore.

Remarks

All hooks must be removed with ISettlers4Api::RemoveListener before terminating the application.

When registering the callback is appended to the end of the callback chain, meaning that the callback will be processed on a first come first serve basis. If your callback is not called it may be due to another mod that consumes it and thus skips the subsequent callbacks.

Requirements

Minimum API Level	1
Target Edition	Any
Header	S4ModApi.h
Library	S4ModApi.lib
DLL	S4ModApi.dll

See also

S4MapInitProc

ISettlers4Api

ISettlers4Api::RemoveListener