Funzione RtlCreateRegistryKey (wdm.h)

La routine RtlCreateRegistryKey aggiunge un oggetto chiave nel Registro di sistema lungo un percorso relativo specificato.

Sintassi

NTSYSAPI NTSTATUS RtlCreateRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Parametri

[in] RelativeTo

Specifica se Path è un percorso del Registro di sistema assoluto o è relativo a un percorso di chiave predefinito come uno dei seguenti.

Valore Significato
RTL_REGISTRY_ABSOLUTE Percorso è un percorso del Registro di sistema assoluto.
RTL_REGISTRY_SERVICES Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT Il percorso è relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP Il percorso è relativo a \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER Il percorso è relativo a \Registry\User\CurrentUser. Per un processo di sistema, questo è \Users\. Impostazione predefinita.

[in] Path

Specifica il percorso del Registro di sistema in base al valore RelativeTo .

Valore restituito

RtlCreateRegistryKey restituisce STATUS_SUCCESS se la chiave viene creata.

Commenti

RtlCreateRegistryKey crea solo le chiavi specificate. Non crea chiavi mancanti nel percorso della chiave specificata. Se mancano chiavi nel percorso, la chiamata avrà esito negativo. Per assicurarsi che esistano tutte le chiavi nel percorso, è necessario chiamare RtlCreateRegistryKey una volta per ogni chiave nel percorso.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedi anche

RtlCheckRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey