Registernyckelobjekt

PortCls-systemdrivrutinen implementerar IRegistryKey-gränssnittet till förmån för miniportdrivrutiner. Ett IRegistryKey-objekt representerar en registernyckel. Miniport-drivrutiner använder registernyckelobjekt för att göra följande:

• Skapa och ta bort registernycklar

• Räkna upp registernycklar

• Fråga efter och ange registernycklar

När du frågar ett registernyckelobjekt om du vill ha information om en registerpost under den angivna nyckeln kan frågan mata ut informationen i ett av tre format, där var och en använder en annan nyckelfrågasstruktur. I följande tabell visas KEY_INFORMATION_CLASS uppräkningsvärden som anger vilken av de tre nyckelfrågasstrukturerna som skickas av frågan.

KEY_INFORMATION_CLASS-värde	Key-Query struktur
KeyBasicInformation	KEY_BASIC_INFORMATION
KeyFullInformation	KEY_FULL_INFORMATION
KeyNodeInformation	KEY_NODE_INFORMATION

Om du vill öppna en befintlig registernyckel eller skapa en ny registernyckel kan en adapterdrivrutin anropa funktionen PcNewRegistryKey , och en miniportdrivrutin kan anropa portdrivrutinens IPort::NewRegistryKey-metod . De två anropen är liknande, förutom att funktionen PcNewRegistryKey kräver ytterligare två parametrar, DeviceObject och SubDevice. Mer information finns i PcNewRegistryKey.

När en miniportdrivrutin skapar ett nytt IRegistryKey-objekt öppnar objektet antingen en befintlig undernyckel eller skapar en ny registerundernyckel om det inte finns någon. I båda fallen lagrar registernyckelobjektet handtaget till nyckeln. När objektet släpps senare och dess referensantal minskar till noll, stänger objektet automatiskt sitt handtag till nyckeln.

Gränssnittet IRegistryKey stöder följande metoder:

IRegistryKey::DeleteKey

IRegistryKey::EnumerateKey

IRegistryKey::EnumerateValueKey

IRegistryKey::NewSubKey

IRegistryKey::QueryKey

IRegistryKey::QueryRegistryValues

IRegistryKey::QueryValueKey

IRegistryKey::SetValueKey