RegQueryInfoKeyW(3w)

RegQueryInfoKeyW3w

Usage

LSTATUS RegQueryInfoKeyW
(
HKEY hkey,
LPWSTR class,
LPDWORD class_len,
LPDWORD reserved,
LPDWORD subkeys,
LPDWORD max_subkey,
LPDWORD max_class,
LPDWORD values,
LPDWORD max_value,
LPDWORD max_data,
LPDWORD security,
FILETIME* modif
)

Overview

Retrieves information about the specified registry key.

Params

hkey [In] Handle to key to query.

class [Out] Buffer for class string.

class_len [Out] Size of class string buffer.

reserved [In] Reserved.

subkeys [Out] Buffer for number of subkeys.

max_subkey [Out] Buffer for longest subkey name length.

max_class [Out] Buffer for longest class string length.

values [Out] Buffer for number of value entries.

max_value [Out] Buffer for longest value name length.

max_data [Out] Buffer for longest value data length.

security [Out] Buffer for security descriptor length.

modif [Out] Modification time.

Returns

Success: ERROR_SUCCESS

Failure: system error code.

Notes

- win95 allows class to be valid and class_len to be NULL

- winnt returns ERROR_INVALID_PARAMETER if class is valid and class_len is NULL

- both allow class to be NULL and class_len to be NULL (it's hard to test validity, so test !NULL instead)

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.