RegGetValueW(3w)

NAME

RegGetValueW (ADVAPI32.@)

SYNOPSIS

LSTATUS RegGetValueW
 (
  HKEY    hKey,
  LPCWSTR pszSubKey,
  LPCWSTR pszValue,
  DWORD   dwFlags,
  LPDWORD pdwType,
  PVOID   pvData,
  LPDWORD pcbData
 )

DESCRIPTION

Retrieves the type and data for a value name associated with a key, optionally expanding its content and restricting its type.

PARAMS

hKey [In] Handle to an open key.

pszSubKey [In] Name of the subkey of hKey.

pszValue [In] Name of value under hKey/szSubKey to query.

dwFlags [In] Flags restricting the value type to retrieve.

pdwType [Out] Destination for the values type, may be NULL.

pvData [Out] Destination for the values content, may be NULL.

pcbData [In/Out] Size of pvData, updated with the size in bytes required to retrieve the whole content, including the trailing ' ' for strings.

RETURNS

Success: ERROR_SUCCESS

Failure: nonzero error code from Winerror.h.

NOTES

- Unless RRF_NOEXPAND is specified, REG_EXPAND_SZ values are automatically expanded and pdwType is set to REG_SZ instead.

- Restrictions are applied after expanding, using RRF_RT_REG_EXPAND_SZ without RRF_NOEXPAND is thus not allowed. An exception is the case where RRF_RT_ANY is specified, because then RRF_NOEXPAND is allowed.

IMPLEMENTATION

Defined in "winreg.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/advapi32/registry.c".

Debug channel "reg".
Copyright © 2010-2025 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout