INF RegisterDlls Direktive
Achtung
Ab Windows 11 Version 22H2 ist ein Treiberpaket, das diese Direktive verwendet, nicht mehr für eine Signatur vom Hardware Developer Center geeignet.
Universelle Treiberpakete und Windows-Treiber können diese Direktive nicht verwenden.
Hinweis
Sie können das Tool Reg2inf verwenden, um vorhandene INF RegisterDlls Direktiven in INF AddReg Direktiven zu konvertieren, um ein Treiber Paket Universal zu machen.
Eine RegisterDlls-Direktive verweist auf einen oder mehrere INF-Abschnitte, die zur Angabe von Dateien dienen, die OLE-Steuerelemente sind und eine Selbstregistrierung erfordern.
[DDInstall]
RegisterDlls=register-dll-section[,register-dll-section]...
Jeder INF-Abschnitt, auf den eine RegisterDlls-Direktive verweist, muss das folgende Eintragsformat haben:
[register-dll-section]
dirid,[subdir],filename,registration-flags[,[timeout][,argument]]
Ein register-dll-section kann eine beliebige Anzahl von Einträgen haben, jeder in einer eigenen Zeile.
Entries
dirid
Gibt die Zielverzeichnis-ID der zu registrierenden Datei an. Weitere Informationen finden Sie unter Verwenden von Dirids.
subdir
Gibt den Verzeichnispfad, relativ zum aktuellen Verzeichnis, zu der zu registrierenden Datei an. Wenn nichts angegeben wird, befindet sich die Datei im aktuellen Verzeichnis.
filename
Gibt den Dateinamen des zu registrierenden OLE-Steuerelements an.
registration-flags
Gibt an, welche Vorgänge bei der Registrierung des OLE-Steuerelements durchgeführt werden sollen. Einer oder beide der folgenden Flags müssen angegeben werden.
0x00000001 (FLG_REGSVR_DLLREGISTER)
Rufen Sie die Funktion DllRegisterServer des OLE-Steuerelements auf (beschrieben in der Windows SDK Dokumentation).
0x00000002 (FLG_REGSVR_DLLINSTALL)
Rufen Sie die Funktion DllInstall des OLE-Steuerelements auf (beschrieben in der Windows SDK-Dokumentation).
timeout
Gibt die Zeitspanne in Einheiten von Sekunden an, die ein OLE-Steuerelement benötigt, um die angegebenen Registrierungsaufrufe abzuschließen. Der Standardwert für die Zeitüberschreitung ist 60 Sekunden.
argument
Handelt es sich bei dem Steuerelement um eine ausführbare Datei, ist dies eine Zeichenfolge, die an die ausführbare Datei übergeben wird. Das Standardargument ist /RegServer.
Handelt es sich bei dem Steuerelement nicht um eine ausführbare Datei, gibt dies das Kommandozeilenargument an, das an die Funktion DllInstall übergeben wird.
Hinweise
Jeder register-dll-section-Name muss in der INF-Datei eindeutig sein und den allgemeinen Regeln für die Definition von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Die folgenden Regeln gelten für die Verwendung der Direktive RegisterDlls bei der Installation von Geräten:
Obwohl die Syntax zulässt, dass der Dateiname entweder eine DLL oder eine ausführbare Datei sein kann, ist für Geräteinstallationen nur eine DLL zugelassen.
Der zu registrierende Code darf nicht nach Benutzereingaben fragen.
Serverseitige Installationen werden in einem Systemkontext ausgeführt. Daher müssen Sie sehr sicher sein, dass der zu registrierende Code keine Sicherheitsschwachstellen enthält und dass die Dateiberechtigungen verhindern, dass der Code schädlich verändert werden kann.
Weitere Informationen über OLE-Steuerelemente und die Selbstregistrierung finden Sie in der Windows SDK-Dokumentation.
Beispiele
[Dialer]
RegisterDlls = DialerRegSvr
[DialerUninstall]
UnregisterDlls = DialerRegSvr
[DialerRegSvr]
11,,avtapi.dll, 1