Macromedia flash media server 2-managing flash media server ユーザーズマニュアル

Access DLL

225

Access DLL is the 

libconnect.dll

 file (this module is named the 

libconnect.so

 file in 

Linux installations) stored within the modules/access subdirectory of the root Flash Media 
Server installation. 

When a connection is attempted, Flash Media Server first determines whether or not Access 
DLL exists. 

■

If the Access module is available, the module is initialized on server startup with a context 
pointer. The module also provides an adaptor interface to the server. Together, the context 
pointer and adaptor pointer provide for two-way communications between the access 
module and the main server. This context pointer can be used to gather server statistics. 

■

If the Access module is not available, all connection requests proceed as usual. The 
connection is accepted pending resources and valid application name.

Configuring Access DLL

The Flash Media Server administrator can configure how the Access DLL module handles 
connection requests for the server’s resources. When the connection request from a client is 
first attempted, the Access module intercepts the request before sending it to the server. The 
Access DLL module calls upon its APIs to examine the information contained within the 
connection request and authorizes or rejects the connection request. 

The Access module uses the following APIs to examine the request: 

■

The connection request activates the 

onAccess

 callback function within the Access 

module. 

■

The 

setValue

 function determines which field to examine and authenticate. 

■

You select this field when you configure the 

setValue

 API. 

■

The Access DLL module makes the value defined by the 

setValue

 function available to 

the 

getValue

 API.

■

The 

getValue

 function returns the value found in the predefined field of the connection 

message. 

■

The 

OnAccess

 function accepts or rejects the connection. 

■

The 

getStats

 function collects server statistics from the context pointer. 

When you configure this module, you can use the sample DLL authentication supplied by 
Macromedia or apply your own authentication mechanism to intercept and examine 
connection attempts to Flash Media Server.