1998-03-28 05:44:41 +03:00
|
|
|
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
|
|
*
|
|
|
|
* The contents of this file are subject to the Netscape Public License
|
1999-04-15 09:40:37 +04:00
|
|
|
* Version 1.0 (the "License"); you may not use this file except in
|
|
|
|
* compliance with the License. You may obtain a copy of the License at
|
1998-03-28 05:44:41 +03:00
|
|
|
* http://www.mozilla.org/NPL/
|
|
|
|
*
|
1999-04-15 09:40:37 +04:00
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
1998-03-28 05:44:41 +03:00
|
|
|
* for the specific language governing rights and limitations under the
|
1999-04-15 09:40:37 +04:00
|
|
|
* License.
|
1998-03-28 05:44:41 +03:00
|
|
|
*
|
1999-04-15 09:40:37 +04:00
|
|
|
* The Original Code is Mozilla Communicator client code,
|
|
|
|
* released March 31, 1998.
|
|
|
|
*
|
|
|
|
* The Initial Developer of the Original Code is Netscape Communications
|
|
|
|
* Corporation. Portions created by Netscape are
|
1998-03-28 05:44:41 +03:00
|
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
|
|
|
|
* Reserved.
|
1999-04-15 09:40:37 +04:00
|
|
|
*
|
|
|
|
* Contributors:
|
|
|
|
* Daniel Veditz <dveditz@netscape.com>
|
1998-03-28 05:44:41 +03:00
|
|
|
*/
|
|
|
|
/* NSReg.h
|
|
|
|
*/
|
|
|
|
#ifndef _NSREG_H_
|
|
|
|
#define _NSREG_H_
|
|
|
|
|
1998-06-07 14:20:08 +04:00
|
|
|
#include "xp_core.h"
|
1998-09-02 23:09:30 +04:00
|
|
|
|
|
|
|
typedef void (*nr_RegPackCallbackFunc) (void *userData, int32 bytes, int32 totalBytes);
|
1998-06-07 14:20:08 +04:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
typedef int32 REGERR;
|
|
|
|
typedef int32 RKEY;
|
|
|
|
typedef uint32 REGENUM;
|
|
|
|
typedef void * HREG;
|
|
|
|
|
|
|
|
typedef struct _reginfo
|
|
|
|
{
|
|
|
|
uint16 size; /* must be initialized to sizeof(REGINFO) */
|
|
|
|
uint16 entryType;
|
|
|
|
uint32 entryLength;
|
|
|
|
} REGINFO;
|
|
|
|
|
|
|
|
#define REGERR_OK (0)
|
|
|
|
#define REGERR_FAIL (1)
|
|
|
|
#define REGERR_NOMORE (2)
|
|
|
|
#define REGERR_NOFIND (3)
|
|
|
|
#define REGERR_BADREAD (4)
|
|
|
|
#define REGERR_BADLOCN (5)
|
|
|
|
#define REGERR_PARAM (6)
|
|
|
|
#define REGERR_BADMAGIC (7)
|
|
|
|
#define REGERR_BADCHECK (8)
|
|
|
|
#define REGERR_NOFILE (9)
|
|
|
|
#define REGERR_MEMORY (10)
|
|
|
|
#define REGERR_BUFTOOSMALL (11)
|
|
|
|
#define REGERR_NAMETOOLONG (12)
|
|
|
|
#define REGERR_REGVERSION (13)
|
|
|
|
#define REGERR_DELETED (14)
|
|
|
|
#define REGERR_BADTYPE (15)
|
|
|
|
#define REGERR_NOPATH (16)
|
|
|
|
#define REGERR_BADNAME (17)
|
|
|
|
#define REGERR_READONLY (18)
|
1998-09-02 23:09:30 +04:00
|
|
|
#define REGERR_BADUTF8 (19)
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
/* Total path length */
|
|
|
|
#define MAXREGPATHLEN (2048)
|
|
|
|
/* Name on the path (including null terminator) */
|
|
|
|
#define MAXREGNAMELEN (512)
|
|
|
|
/* Value of an entry */
|
|
|
|
#define MAXREGVALUELEN (0x7FFF)
|
|
|
|
|
|
|
|
/* Standard keys */
|
|
|
|
#define ROOTKEY_USERS (0x01)
|
|
|
|
#define ROOTKEY_COMMON (0x02)
|
|
|
|
#define ROOTKEY_CURRENT_USER (0x03)
|
|
|
|
#define ROOTKEY_PRIVATE (0x04)
|
|
|
|
|
|
|
|
/* enumeration styles */
|
|
|
|
#define REGENUM_NORMAL (0x00)
|
1998-06-07 14:20:08 +04:00
|
|
|
#define REGENUM_CHILDREN REGENUM_NORMAL
|
1998-03-28 05:44:41 +03:00
|
|
|
#define REGENUM_DESCEND (0x01)
|
1998-06-07 14:20:08 +04:00
|
|
|
#define REGENUM_DEPTH_FIRST (0x02)
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
/* entry data types */
|
|
|
|
#define REGTYPE_ENTRY (0x0010)
|
|
|
|
#define REGTYPE_ENTRY_STRING_UTF (REGTYPE_ENTRY + 1)
|
|
|
|
#define REGTYPE_ENTRY_INT32_ARRAY (REGTYPE_ENTRY + 2)
|
|
|
|
#define REGTYPE_ENTRY_BYTES (REGTYPE_ENTRY + 3)
|
1998-10-21 00:53:56 +04:00
|
|
|
#define REGTYPE_ENTRY_FILE (REGTYPE_ENTRY + 4)
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
#define REG_DELETE_LIST_KEY "Netscape/Communicator/SoftwareUpdate/Delete List"
|
|
|
|
#define REG_REPLACE_LIST_KEY "Netscape/Communicator/SoftwareUpdate/Replace List"
|
1998-06-07 14:20:08 +04:00
|
|
|
#define REG_UNINSTALL_DIR "Netscape/Communicator/SoftwareUpdate/Uninstall/"
|
|
|
|
|
1998-09-02 23:09:30 +04:00
|
|
|
#define UNINSTALL_NAV_STR "_"
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
#define UNIX_GLOBAL_FLAG "MOZILLA_SHARED_REGISTRY"
|
|
|
|
|
|
|
|
/* Platform-dependent declspec for library interface */
|
1998-05-23 01:56:30 +04:00
|
|
|
#if defined(XP_PC)
|
|
|
|
#if defined(WIN32)
|
1998-10-21 00:53:56 +04:00
|
|
|
|
|
|
|
#if defined (STANDALONE_REGISTRY)
|
|
|
|
#define VR_INTERFACE(type) __declspec(dllexport) type __cdecl
|
|
|
|
#else
|
|
|
|
#define VR_INTERFACE(type) __declspec(dllexport) type __stdcall
|
|
|
|
#endif
|
|
|
|
|
1998-05-23 01:56:30 +04:00
|
|
|
#elif defined(XP_OS2)
|
|
|
|
#define VR_INTERFACE(type) type _Optlink
|
|
|
|
#else
|
|
|
|
#define VR_INTERFACE(type) type _far _pascal _export
|
|
|
|
#endif
|
1998-06-07 14:20:08 +04:00
|
|
|
#elif defined XP_MAC
|
|
|
|
#define VR_INTERFACE(__x) __declspec(export) __x
|
1998-03-28 05:44:41 +03:00
|
|
|
#else
|
1998-06-07 14:20:08 +04:00
|
|
|
#define VR_INTERFACE(type) type
|
1998-05-23 01:56:30 +04:00
|
|
|
#endif
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
XP_BEGIN_PROTOS
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* Registry API -- General
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegOpen - Open a netscape XP registry
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* filename - registry file to open. NULL or "" opens the standard
|
|
|
|
* local registry.
|
|
|
|
* hReg - OUT: handle to opened registry
|
|
|
|
*
|
|
|
|
* Output:
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegOpen(
|
|
|
|
char *filename, /* reg. file to open (NULL == standard registry) */
|
|
|
|
HREG *hReg /* OUT: handle to opened registry */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegClose - Close a netscape XP registry
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry to be closed.
|
|
|
|
*
|
|
|
|
* After calling this routine the handle is no longer valid
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegClose(
|
|
|
|
HREG hReg /* handle of open registry to close */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegIsWritable - Check read/write status of open registry
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry to query
|
1999-05-19 06:02:47 +04:00
|
|
|
* Returns:
|
|
|
|
* REGERR_OK if writable, REGERR_READONLY if not, possibly
|
|
|
|
* other errors for an invalid hReg
|
1999-04-15 09:40:37 +04:00
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
VR_INTERFACE(REGERR) NR_RegIsWritable(
|
|
|
|
HREG hReg /* handle of open registry to query */
|
|
|
|
);
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegPack(
|
1998-09-02 23:09:30 +04:00
|
|
|
HREG hReg, /* handle of open registry to pack */
|
|
|
|
void *userData,
|
|
|
|
nr_RegPackCallbackFunc fn
|
1998-03-28 05:44:41 +03:00
|
|
|
);
|
|
|
|
|
1998-06-07 14:20:08 +04:00
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegSetUsername - Set the current username
|
|
|
|
*
|
|
|
|
* If the current user profile name is not set then trying to use
|
|
|
|
* HKEY_CURRENT_USER will result in an error.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* name - name of the current user
|
|
|
|
*
|
|
|
|
* Output:
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-05-23 01:56:30 +04:00
|
|
|
VR_INTERFACE(REGERR) NR_RegSetUsername(
|
1999-04-02 05:31:55 +04:00
|
|
|
const char *name /* name of current user */
|
1998-05-23 01:56:30 +04:00
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* DO NOT USE -- Will be removed
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
VR_INTERFACE(REGERR) NR_RegGetUsername(
|
|
|
|
char **name /* on return, an alloc'ed copy of the current user name */
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* Registry API -- Key Management functions
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegAddKey - Add a key node to the registry
|
|
|
|
*
|
|
|
|
* Can also be used to find an existing node for convenience.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - registry key obtained from NR_RegGetKey(),
|
|
|
|
* or one of the standard top-level keys
|
|
|
|
* path - relative path of key to be added. Intermediate
|
|
|
|
* nodes will be added if necessary.
|
|
|
|
* newkey - If not null returns RKEY of new or found node
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegAddKey(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *path, /* relative path of subkey to add */
|
|
|
|
RKEY *newKey /* if not null returns newly created key */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegAddKeyRaw - Add a key node to the registry
|
|
|
|
*
|
|
|
|
* This routine is different from NR_RegAddKey() in that it takes
|
|
|
|
* a keyname rather than a path.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - registry key obtained from NR_RegGetKey(),
|
|
|
|
* or one of the standard top-level keys
|
|
|
|
* keyname - name of key to be added. No parsing of this
|
|
|
|
* name happens.
|
|
|
|
* newkey - if not null the RKEY of the new key is returned
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1999-03-08 23:35:54 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegAddKeyRaw(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *keyname, /* name of key to add */
|
|
|
|
RKEY *newKey /* if not null returns newly created key */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegDeleteKey - Delete the specified key
|
|
|
|
*
|
|
|
|
* Note that delete simply orphans blocks and makes no attempt
|
|
|
|
* to reclaim space in the file. Use NR_RegPack()
|
|
|
|
*
|
|
|
|
* Cannot be used to delete keys with child keys
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - starting node RKEY, typically one of the standard ones.
|
|
|
|
* path - relative path of key to delete
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegDeleteKey(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *path /* relative path of subkey to delete */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegDeleteKeyRaw - Delete the specified raw key
|
|
|
|
*
|
|
|
|
* Note that delete simply orphans blocks and makes no attempt
|
|
|
|
* to reclaim space in the file. Use NR_RegPack()
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY or parent to the raw key you wish to delete
|
|
|
|
* keyname - name of child key to delete
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1999-03-08 23:35:54 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegDeleteKeyRaw(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *keyname /* name subkey to delete */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegGetKey - Get the RKEY value of a node from its path
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - starting node RKEY, typically one of the standard ones.
|
|
|
|
* path - relative path of key to find. (a blank path just gives you
|
|
|
|
* the starting key--useful for verification, VersionRegistry)
|
|
|
|
* result - if successful the RKEY of the specified sub-key
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegGetKey(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *path, /* relative path of subkey to find */
|
|
|
|
RKEY *result /* returns RKEY of specified sub-key */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegGetKeyRaw - Get the RKEY value of a node from its keyname
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - starting node RKEY, typically one of the standard ones.
|
|
|
|
* keyname - keyname of key to find. (a blank keyname just gives you
|
|
|
|
* the starting key--useful for verification, VersionRegistry)
|
|
|
|
* result - if successful the RKEY of the specified sub-key
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1999-03-08 23:35:54 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegGetKeyRaw(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* root key */
|
|
|
|
char *keyname, /* name of key to get */
|
|
|
|
RKEY *result /* returns RKEY of specified sub-key */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegEnumSubkeys - Enumerate the subkey names for the specified key
|
|
|
|
*
|
|
|
|
* Returns REGERR_NOMORE at end of enumeration.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key to enumerate--obtain with NR_RegGetKey()
|
|
|
|
* eState - enumerations state, must contain NULL to start
|
|
|
|
* buffer - location to store subkey names. Once an enumeration
|
|
|
|
* is started user must not modify contents since values
|
|
|
|
* are built using the previous contents.
|
|
|
|
* bufsize - size of buffer for names
|
|
|
|
* style - 0 returns direct child keys only, REGENUM_DESCEND
|
|
|
|
* returns entire sub-tree
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegEnumSubkeys(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
REGENUM *state, /* enum state, must be NULL to start */
|
|
|
|
char *buffer, /* buffer for entry names */
|
|
|
|
uint32 bufsize, /* size of buffer */
|
|
|
|
uint32 style /* 0: children only; REGENUM_DESCEND: sub-tree */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* Registry API -- Entry Management functions
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegGetEntryInfo - Get some basic info about the entry data
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* info - return: Entry info object
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegGetEntryInfo(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name, /* entry name */
|
|
|
|
REGINFO *info /* returned entry info */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegGetEntryString - Get the UTF string value associated with the
|
|
|
|
* named entry of the specified key.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* buffer - destination for string
|
|
|
|
* bufsize - size of buffer
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegGetEntryString(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name, /* entry name */
|
|
|
|
char *buffer, /* buffer to hold value (UTF String) */
|
|
|
|
uint32 bufsize /* length of buffer */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegGetEntry - Get the value data associated with the
|
|
|
|
* named entry of the specified key.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* buffer - destination for data
|
|
|
|
* size - in: size of buffer
|
|
|
|
* out: size of actual data (incl. \0 term. for strings)
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegGetEntry(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name, /* entry name */
|
|
|
|
void *buffer, /* buffer to hold value */
|
|
|
|
uint32 *size /* in:length of buffer */
|
|
|
|
); /* out: data length, >>includes<< null terminator*/
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegSetEntryString - Store a UTF-8 string value associated with the
|
|
|
|
* named entry of the specified key. Used for
|
|
|
|
* both creation and update.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* buffer - UTF-8 String to store
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegSetEntryString(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name, /* entry name */
|
|
|
|
char *buffer /* UTF String value */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegSetEntry - Store value data associated with the named entry
|
|
|
|
* of the specified key. Used for both creation and update.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* type - type of data to be stored
|
|
|
|
* buffer - data to store
|
|
|
|
* size - length of data to store in bytes
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegSetEntry(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name, /* entry name */
|
|
|
|
uint16 type, /* type of value data */
|
|
|
|
void *buffer, /* data buffer */
|
|
|
|
uint32 size /* data length in bytes; incl. null term for strings */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegDeleteEntry - Delete the named entry
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* name - name of entry
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegDeleteEntry(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
char *name /* value name */
|
|
|
|
);
|
|
|
|
|
1999-04-15 09:40:37 +04:00
|
|
|
|
|
|
|
/* ---------------------------------------------------------------------
|
|
|
|
* NR_RegEnumEntries - Enumerate the entry names for the specified key
|
|
|
|
*
|
|
|
|
* Returns REGERR_NOMORE at end of enumeration.
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* hReg - handle of open registry
|
|
|
|
* key - RKEY of key that contains entry--obtain with NR_RegGetKey()
|
|
|
|
* eState - enumerations state, must contain NULL to start
|
|
|
|
* buffer - location to store entry names
|
|
|
|
* bufsize - size of buffer for names
|
|
|
|
* ---------------------------------------------------------------------
|
|
|
|
*/
|
1998-03-28 05:44:41 +03:00
|
|
|
VR_INTERFACE(REGERR) NR_RegEnumEntries(
|
|
|
|
HREG hReg, /* handle of open registry */
|
|
|
|
RKEY key, /* containing key */
|
|
|
|
REGENUM *state, /* enum state, must be NULL to start */
|
|
|
|
char *buffer, /* buffer for entry names */
|
|
|
|
uint32 bufsize, /* size of buffer */
|
|
|
|
REGINFO *info /* optional; returns info about entry */
|
|
|
|
);
|
|
|
|
|
1998-10-21 00:53:56 +04:00
|
|
|
|
1999-04-02 05:31:55 +04:00
|
|
|
VR_INTERFACE(void) NR_ShutdownRegistry(void);
|
|
|
|
VR_INTERFACE(REGERR) NR_StartupRegistry(void);
|
1998-10-21 00:53:56 +04:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
XP_END_PROTOS
|
|
|
|
|
|
|
|
#endif /* _NSREG_H_ */
|
|
|
|
|
|
|
|
/* EOF: NSReg.h */
|
|
|
|
|