Dyrektywa INF DelReg

Caution

Jeśli tworzysz uniwersalny lub Windows pakiet sterowników, ta dyrektywa jest nieprawidłowa. Zobacz Using a Universal INF File (Używanie uniwersalnego pliku INF) i Get started developing Windows drivers (Rozpoczynanie opracowywania sterowników Windows).

Dyrektywa DelReg odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF opisujących klucze i/lub wpisy wartości, które mają zostać usunięte z rejestru.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
DelReg=del-registry-section[,del-registry-section]...

Każda sekcja del-registry , do których odwołuje się dyrektywa DelReg , ma następującą postać:

[del-registry-section]
reg-root-string,subkey[,value-entry-name][,flags][,value]
reg-root-string,subkey[,value-entry-name][,flags][,value]
...

Sekcja del-registry-może zawierać dowolną liczbę wpisów, z których każda jest w osobnym wierszu.

Wpisy

reg-root-string
Identyfikuje katalog główny drzewa rejestru dla innych wartości podanych w tym wpisie. Może to być jedna z następujących wartości:

HKCR
Skrót HKEY_CLASSES_ROOT.

HKCU (Międzynarodowa Organizacja Turystyczna
Skrót HKEY_CURRENT_USER.

HKLM powiedział:
Skrót HKEY_LOCAL_MACHINE.

HKU
Skrót dla HKEY_USERS.

HKR
Względny katalog główny, w którym klucze określone za pomocą tego skrótu są względne względem klucza rejestru skojarzonego z sekcją INF, w której pojawia się ta dyrektywa DelReg , jak wskazano w poniższej tabeli.

Sekcja INF zawierająca dyrektywę AddReg Klucz rejestru przywołyny przez HKR
Sekcja INF DDInstall Klucz oprogramowania urządzenia
INF DDInstall. Sekcja HW Klucz sprzętowy urządzenia
INF DDInstall. Sekcja usług Klucz usług

Uwaga

Nie można użyć rejestru HKR w sekcji del-registry, do której odwołuje się sekcja INF DefaultInstall.

Aby uzyskać więcej informacji o sterownikach przechowywanych w katalogu głównym HKEY_LOCAL_MACHINE , zobacz Drzewa rejestru i klucze dla urządzeń i sterowników.

podklucz
Ta opcjonalna wartość, utworzona jako %strkey% token zdefiniowany w sekcji Ciągi INF lub jako ścieżka rejestru w danym reg-root (klucz1\klucz2\klucz3...), określa jedną z następujących wartości:

  • Podklucz, który ma zostać usunięty z rejestru na końcu podanej ścieżki rejestru

  • Istniejący podklucz, z którego należy usunąć daną wartość-entry-name

value-entry-name
Ta wartość identyfikuje nazwany wpis wartości do usunięcia z danego podklucza. Ta wartość i poprzedni przecinek powinny zostać pominięte, jeśli sam podklucz zostanie usunięty z rejestru.

flagi (Windows XP i nowsze wersje Windows).
Ta opcjonalna wartość szesnastkowa, wyrażona jako maska bitów ORed zdefiniowanych przez system wartości niskich wyrazów i flag wysokich wyrazów, definiuje typ danych dla wpisu wartości lub kontroluje operację usuwania rejestru. Jeśli flagi nie zostaną określone, zostanie usunięta wartość-entry-name (jeśli określono) lub podklucz .

Wartości maski bitów dla każdej z tych flag są następujące:

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Usuń cały podklucz.

0x00004000 (FLG_DELREG_32BITKEY)
Wprowadź określoną zmianę w rejestrze 32-bitowym. Jeśli nie zostanie określony, zmiana zostanie wprowadzona do rejestru natywnego.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING)
W wpisie rejestru wielociągowego usuń wszystkie ciągi pasujące do wartości ciągu określonej przez wartość. Wielkość liter jest ignorowana.

value (Windows XP i nowsze wersje Windows).
Określa wartość rejestru, jeśli flagi wskazują, że wartość rejestru jest wymagana.

Remarks

Dyrektywę DelReg można określić w dowolnych sekcjach przedstawionych w powyższej instrukcji składni formalnej. Tę dyrektywę można również określić w dowolnej z następujących sekcji zdefiniowanych przez moduł zapisywania INF:

Ogólnie rzecz biorąc, inf nigdy nie powinien próbować usuwać podkluczy lub wpisów wartości w istniejących podkluczach, które zostały skonfigurowane przez składniki systemowe lub pliki INF dla innych urządzeń. Celem sekcji del-registry-section jest czyszczenie nieaktualnych informacji rejestru z poprzedniej instalacji przy użyciu nowego pliku INF dostarczonego przez tego samego dostawcę.

Każda nazwa sekcji del-registry musi być unikatowa dla pliku INF, ale może być przywołyni przez dyrektywy DelReg w innych sekcjach tego samego inf. Każda nazwa sekcji musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

W przypadku wersji systemu operacyjnego wcześniejszych niż Windows XP jedynym sposobem usunięcia klucza jest określenie następujących elementów:

reg-root-string, subkey

W przypadku Windows XP i nowszych wersji Windows dozwolone jest również następujące (aby określić rejestr 32-bitowy):

reg-root-string, subkey,,0x4000

Examples

W tym przykładzie pokazano, jak dostarczony przez system portów COM/LPT instalator klasy INF usuwa nieaktualne informacje rejestru nt o portach COM z rejestru.

[ComPort.NT]
AddReg=ComPort.NT.AddReg
 ... ; more directives omitted here

[ComPort.NT.HW]
DelReg=ComPort.NT.HW.DelReg

[Comport.NT.AddReg]
HKR,,EnumPropPages32,,"MSPorts.dll,SerialPortPropPageProvider"

[ComPort.NT.HW.DelReg]
HKR,,UpperFilters

Informacje dodatkowe

DodajReg

AddInterface

AddService

ClassInstall32

DDInstall

DDInstall. HW

DDInstall. Usługi

InterfaceInstall32

Ciągi