RegCreateKeyExA(3w)

RegCreateKeyExA3w

Usage

LSTATUS RegCreateKeyExA
(
HKEY hkey,
LPCSTR name,
DWORD reserved,
LPSTR class,
DWORD options,
REGSAM access,
SECURITY_ATTRIBUTES* sa,
PHKEY retkey,
LPDWORD dispos
)

Overview

Open a registry key, creating it if it doesn't exist.

Params

hkey [In] Handle of the parent registry key.

name [In] Name of the new key to open or create.

reserved [In] Reserved, pass 0.

class [In] The object type of the new key.

options [In] Flags controlling the key creation (REG_OPTION_* flags from "winnt.h").

access [In] Access level desired.

sa [In] Security attributes for the key.

retkey [Out] Destination for the resulting handle.

dispos [Out] Receives REG_CREATED_NEW_KEY or REG_OPENED_EXISTING_KEY.

Returns

Success: ERROR_SUCCESS.

Failure: A standard Win32 error code. retkey remains untouched.

Fixme

MAXIMUM_ALLOWED in access mask not supported by server

Implementation

Declared in "winreg.h".

Implemented in "dlls/advapi32/registry.c".

Debug channel "reg".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.