Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: e32std.h
Link against:

Enum TDllReason

TDllReason

Support

Supported from 5.0

Description

Defines the context in which the DLL is entered. The meaning of the enumerator values depends on the target implementation, i.e. ARM or WINS. This enumeration is used as an argument to the function E32Dll(), the main DLL entry point.

EDllProcessAttach

WINS implementation: Indicates that a DLL is attaching to the current process as a result of the process starting up or as a result of the first load of this DLL in the current process. A DLL can allocate thread-local storage for the primary thread here.

EDllThreadAttach

ARM implementations: Indicates that the DLL is being attached to a thread either as a result of a static link or as a result of a call to the Load() member function of RLibrary. A DLL can set up thread-local storage here. Indicates that the DLL is being attached to a thread as a result of a static link. The entry point is called when attaching to all threads in the process Do not set thread-local storage when attaching to the primary thread (the first call to the entry point with this reason). Thread-local storage can be set when attaching to secondary threads (the second and subsequent calls to the entry point with this reason). Note, the entry point is not called with this reason when attaching to a thread as a result of a call to the Load() member function of RLibrary.

EDllThreadDetach

ARM Implementations: Indicates that the DLL is being detached from a thread. A DLL can reset thread-local storage here.

EDllProcessDetach

WINS implementation : Indicates that the DLL is detaching from the calling process as a result of a process exit.