static DuplicatedObject * CreateWellKnown( WKHandle & hWK );
Name | Description | |
---|---|---|
in | hWK | Specifies a global variable that indicates a reference to a well-known object instance. Must have the same name as is declared in the DDL file. |
Creates the specified well-known object.
A well-known object is a duplicated object that is guaranteed to have been conveyed to all participants when a session starts. Since all stations can reference well-known objects during the session, for practical purposes they can be handled as global objects. For example, information about the game world (level, weather, opponent AI intelligence and so on) and other information that is absolutely required to start the game can be handled as well-known objects. Different games use well-known objects for different information according to their specifications.
You can use this function to create a well-known object. All well-known objects must be created before the session is created. This function must only be called by the session master.
CONFIDENTIAL