INF RegisterDlls Directive

[DDInstall]
 
RegisterDlls=register-dll-section[,register-dll-section]...
 
 

A RegisterDlls directive references one or more INF sections used to specify files that are OLE controls and require self-registration.

Comments

This directive is supported on Windows 2000 and later. OLE controls and self-registration are described in Platform SDK documentation.

Each register-dll-section name must be unique to the INF file and must follow the general rules for defining section names, described in General Syntax Rules for INF Files.

Each INF section referenced by a RegisterDlls directive must have the following entry format:

[register-dll-section]
 
dirid, subdir, filename, registration flags[, [optional timeout][, argument]]

A register-dll-section can have any number of entries, each on a separate line.

RegisterDlls-Referenced Section Entries

dirid

Specifies the destination directory ID of the file to be registered. For more information, see Using Dirids.

subdir

Optional. Specifies the directory path, relative to the current directory, to the file to be registered. If not specified, the file is in the current directory.

filename

Identifies the file name of the OLE control to be registered.

registration flags

Indicates the registration operations to perform on the OLE control. One or both of the following flags must be specified.

Value	Meaning
FLG_REGSVR_DLLREGISTER (0x00000001)	Call the OLE control's DllRegisterServer function (described in Platform SDK documentation).
FLG_REGSVR_DLLINSTALL (0x00000002)	Call the OLE control's DllInstall function (described in Platform SDK documentation).

timeout

Optional. Specifies the timeout, in seconds, for an OLE Control to complete the specified registration calls. The default timeout is 60 seconds.

argument

Optional. If the control is an executable file, this is a command string passed to the executable. The default argument is /RegServer.

If the control is not an executable file, this specifies the command line argument to pass to the DllInstall function.

The following rules apply to the use of the RegisterDlls directive for device installations:

• Although the syntax permits filename to be either a DLL or an executable file, for device installations only a DLL is allowed.
• The code to be registered must not prompt for user input.
• Server-side installations execute in a system context, so you must be very sure that the code being registered contains no security vulnerabilities and that file permissions prevent the code from being maliciously modified.

Example

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

See Also

INF UnregisterDlls Directive