INF UnregisterDlls 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.
Eine Direktive UnregisterDlls verweist auf einen oder mehrere INF-Abschnitte, die zur Angabe von Dateien verwendet werden, bei denen es sich um OLE-Steuerelemente handelt und die eine Selbstregistrierung (Selbstentfernung) erfordern.
[DDInstall]
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Jeder INF-Abschnitt, der von einer UnregisterDlls-Direktive referenziert wird, muss das folgende Eintragsformat haben:
[unregister-dll-section]
dirid,[subdir],filename,registration-flags[,[timeout][,argument]]
Ein unregister-dll-section kann eine beliebige Anzahl von Einträgen haben, jeder in einer eigenen Zeile.
Entries
dirid
Gibt die ID des Zielverzeichnisses der Datei an, die nicht registriert werden soll. Weitere Informationen finden Sie unter Verwenden von Dirids.
subdir
Gibt den Verzeichnispfad, relativ zum aktuellen Verzeichnis, zu der Datei an, die unregistriert werden soll. Wenn nichts angegeben wird, befindet sich die Datei im aktuellen Verzeichnis.
filename
Gibt den Dateinamen des OLE-Steuerelements an, dessen Registrierung aufgehoben werden soll.
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 DllUnRegisterServer 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 Aufrufe zur Aufhebung der Registrierung 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 /UnRegServer.
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 unregister-dll-Abschnitt-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.
Weitere Informationen über OLE-Steuerelemente und die Aufhebung der Registrierung finden Sie in der Windows SDK-Dokumentation.
Beispiele
[Dialer]
RegisterDlls = DialerRegSvr
[DialerUninstall]
UnregisterDlls = DialerRegSvr
[DialerRegSvr]
11,,avtapi.dll, 1