Freigeben über


ORCloseKey-Funktion

Schließt ein Handle für den angegebenen Registrierungsschlüssel in einer Offlineregistrierungsstruktur.

Syntax

DWORD ORCloseKey(
  _In_ ORHKEY Handle
);

Parameter

Handle [in]

Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Wenn der angegebene Schlüssel der Stammschlüssel der Registrierungsstruktur ist, schlägt die Funktion mit ERROR_INVALID_PARAMETER fehl.

Bemerkungen

Das Handle für einen angegebenen Schlüssel sollte nach dem Schließen nicht mehr verwendet werden, da es nicht mehr gültig ist. Schlüsselhandles sollten nicht länger als erforderlich geöffnet bleiben.

Verwenden Sie die ORCloseHive-Funktion , um eine Offlineregistrierungsstruktur zu schließen.

Anforderungen

Anforderung Wert
Verteilbare Komponente
Windows-Offlineregistrierungsbibliothek, Version 1.0 oder höher
Header
Offreg.h
DLL
Offreg.dll

Siehe auch

ORCloseHive

ORCreateKey

ORDeleteKey

OROpenKey