?HAMA

Navigation

Breadcrumbs

/ / usr / include / apache2

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 8.97 KB

//usr/include/apache2/ap_regkey.h

Text Base64

/* Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * @file ap_regkey.h
 * @brief APR-style Win32 Registry Manipulation
 */

#ifndef AP_REGKEY_H
#define AP_REGKEY_H

#if defined(WIN32) || defined(DOXYGEN)

#include "apr.h"
#include "apr_pools.h"
#include "ap_config.h"      /* Just for AP_DECLARE */

#ifdef __cplusplus
extern "C" {
#endif

typedef struct ap_regkey_t ap_regkey_t;

/* Used to recover AP_REGKEY_* constants
 */
AP_DECLARE(const ap_regkey_t *) ap_regkey_const(int i);

/**
 * Win32 Only: Constants for ap_regkey_open()
 */
#define AP_REGKEY_CLASSES_ROOT         ap_regkey_const(0)
#define AP_REGKEY_CURRENT_CONFIG       ap_regkey_const(1)
#define AP_REGKEY_CURRENT_USER         ap_regkey_const(2)
#define AP_REGKEY_LOCAL_MACHINE        ap_regkey_const(3)
#define AP_REGKEY_USERS                ap_regkey_const(4)
#define AP_REGKEY_PERFORMANCE_DATA     ap_regkey_const(5)
#define AP_REGKEY_DYN_DATA             ap_regkey_const(6)

/**
 * Win32 Only: Flags for ap_regkey_value_set()
 */
#define AP_REGKEY_EXPAND               0x0001

/**
 * Win32 Only: Open the specified registry key.
 * @param newkey The opened registry key
 * @param parentkey The open registry key of the parent, or one of
 * <PRE>
 *           AP_REGKEY_CLASSES_ROOT
 *           AP_REGKEY_CURRENT_CONFIG
 *           AP_REGKEY_CURRENT_USER
 *           AP_REGKEY_LOCAL_MACHINE
 *           AP_REGKEY_USERS
 *           AP_REGKEY_PERFORMANCE_DATA
 *           AP_REGKEY_DYN_DATA
 * </PRE>
 * @param keyname The path of the key relative to the parent key
 * @param flags Or'ed value of:
 * <PRE>
 *           APR_READ             open key for reading
 *           APR_WRITE            open key for writing
 *           APR_CREATE           create the key if it doesn't exist
 *           APR_EXCL             return error if APR_CREATE and key exists
 * </PRE>
 * @param pool The pool in which newkey is allocated
 */
AP_DECLARE(apr_status_t) ap_regkey_open(ap_regkey_t **newkey,
                                        const ap_regkey_t *parentkey,
                                        const char *keyname,
                                        apr_int32_t flags,
                                        apr_pool_t *pool);

/**
 * Win32 Only: Close the registry key opened or created by ap_regkey_open().
 * @param key The registry key to close
 */
AP_DECLARE(apr_status_t) ap_regkey_close(ap_regkey_t *key);

/**
 * Win32 Only: Remove the given registry key.
 * @param parent The open registry key of the parent, or one of
 * <PRE>
 *           AP_REGKEY_CLASSES_ROOT
 *           AP_REGKEY_CURRENT_CONFIG
 *           AP_REGKEY_CURRENT_USER
 *           AP_REGKEY_LOCAL_MACHINE
 *           AP_REGKEY_USERS
 *           AP_REGKEY_PERFORMANCE_DATA
 *           AP_REGKEY_DYN_DATA
 * </PRE>
 * @param keyname The path of the key relative to the parent key
 * @param pool The pool used for temp allocations
 * @remark ap_regkey_remove() is not recursive, although it removes
 * all values within the given keyname, it will not remove a key
 * containing subkeys.
 */
AP_DECLARE(apr_status_t) ap_regkey_remove(const ap_regkey_t *parent,
                                          const char *keyname,
                                          apr_pool_t *pool);

/**
 * Win32 Only: Retrieve a registry value string from an open key.
 * @param result The string value retrieved
 * @param key The registry key to retrieve the value from
 * @param valuename The named value to retrieve (pass "" for the default)
 * @param pool The pool used to store the result
 * @remark There is no toggle to prevent environment variable expansion
 * if the registry value is set with AP_REG_EXPAND (REG_EXPAND_SZ), such
 * expansions are always performed.
 */
AP_DECLARE(apr_status_t) ap_regkey_value_get(char **result,
                                             ap_regkey_t *key,
                                             const char *valuename,
                                             apr_pool_t *pool);

/**
 * Win32 Only: Store a registry value string into an open key.
 * @param key The registry key to store the value into
 * @param valuename The named value to store (pass "" for the default)
 * @param value The string to store for the named value
 * @param flags The option AP_REGKEY_EXPAND or 0, where AP_REGKEY_EXPAND
 * values will find all %foo% variables expanded from the environment.
 * @param pool The pool used for temp allocations
 */
AP_DECLARE(apr_status_t) ap_regkey_value_set(ap_regkey_t *key,
                                             const char *valuename,
                                             const char *value,
                                             apr_int32_t flags,
                                             apr_pool_t *pool);

/**
 * Win32 Only: Retrieve a raw byte value from an open key.
 * @param result The raw bytes value retrieved
 * @param resultsize Pointer to a variable to store the number raw bytes retrieved
 * @param resulttype Pointer to a variable to store the registry type of the value retrieved
 * @param key The registry key to retrieve the value from
 * @param valuename The named value to retrieve (pass "" for the default)
 * @param pool The pool used to store the result
 */
AP_DECLARE(apr_status_t) ap_regkey_value_raw_get(void **result,
                                                 apr_size_t *resultsize,
                                                 apr_int32_t *resulttype,
                                                 ap_regkey_t *key,
                                                 const char *valuename,
                                                 apr_pool_t *pool);

/**
 * Win32 Only: Store a raw bytes value into an open key.
 * @param key The registry key to store the value into
 * @param valuename The named value to store (pass "" for the default)
 * @param value The bytes to store for the named value
 * @param valuesize The number of bytes for value
 * @param valuetype The
 * values will find all %foo% variables expanded from the environment.
 * @param pool The pool used for temp allocations
 */
AP_DECLARE(apr_status_t) ap_regkey_value_raw_set(ap_regkey_t *key,
                                                 const char *valuename,
                                                 const void *value,
                                                 apr_size_t  valuesize,
                                                 apr_int32_t valuetype,
                                                 apr_pool_t *pool);

/**
 * Win32 Only: Retrieve a registry value string from an open key.
 * @param result The string elements retrieved from a REG_MULTI_SZ string array
 * @param key The registry key to retrieve the value from
 * @param valuename The named value to retrieve (pass "" for the default)
 * @param pool The pool used to store the result
 */
AP_DECLARE(apr_status_t) ap_regkey_value_array_get(apr_array_header_t **result,
                                                   ap_regkey_t *key,
                                                   const char *valuename,
                                                   apr_pool_t *pool);

/**
 * Win32 Only: Store a registry value string array into an open key.
 * @param key The registry key to store the value into
 * @param valuename The named value to store (pass "" for the default)
 * @param nelts The string elements to store in a REG_MULTI_SZ string array
 * @param elts The number of elements in the elts string array
 * @param pool The pool used for temp allocations
 */
AP_DECLARE(apr_status_t) ap_regkey_value_array_set(ap_regkey_t *key,
                                                   const char *valuename,
                                                   int nelts,
                                                   const char * const * elts,
                                                   apr_pool_t *pool);

/**
 * Win32 Only: Remove a registry value from an open key.
 * @param key The registry key to remove the value from
 * @param valuename The named value to remove (pass "" for the default)
 * @param pool The pool used for temp allocations
 */
AP_DECLARE(apr_status_t) ap_regkey_value_remove(const ap_regkey_t *key,
                                                const char *valuename,
                                                apr_pool_t *pool);

#ifdef __cplusplus
}
#endif

#endif /* def WIN32 || def DOXYGEN */

#endif /* AP_REGKEY_H */

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 0 × Files: 66

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
.mmn	14 B	lrw-r--r--	2026-01-27 02:08:10	Edit Download recursive recursive
apache_noprobes.h	15.59 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_compat.h	1.05 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config.h	6.45 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config_auto.h	9.90 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config_layout.h	2.52 KB	lrw-r--r--	2026-01-27 02:08:11	Edit Download recursive recursive
ap_expr.h	13.75 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_hooks.h	5.85 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_listen.h	6.19 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_mmn.h	39.53 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_mpm.h	10.51 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_provider.h	3.45 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_regex.h	11.14 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_regkey.h	8.97 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_release.h	3.07 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_slotmem.h	7.07 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_socache.h	9.18 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
cache_common.h	1.97 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
heartbeat.h	1.56 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
httpd.h	95.02 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_config.h	56.37 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
http_connection.h	6.97 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
http_core.h	36.40 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_log.h	36.01 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_main.h	3.17 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_protocol.h	41.41 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_request.h	25.72 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_ssl.h	14.62 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_vhost.h	4.49 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_auth.h	4.42 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_cache.h	7.09 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_cgi.h	2.44 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_core.h	3.33 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_dav.h	97.85 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_dbd.h	4.06 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_http2.h	4.59 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_include.h	3.89 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_log_config.h	2.43 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_proxy.h	65.80 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_request.h	1.59 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_rewrite.h	1.36 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_session.h	6.61 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_so.h	1.20 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_ssl.h	4.87 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_ssl_openssl.h	4.80 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_status.h	2.38 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_unixd.h	1.09 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_watchdog.h	7.34 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_xml2enc.h	2.25 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mpm_common.h	17.09 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
os.h	1.63 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
scoreboard.h	9.94 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
unixd.h	4.14 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
util_cfgtree.h	3.08 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_charset.h	2.21 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_cookies.h	4.84 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_ebcdic.h	2.69 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_fcgi.h	9.75 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_filter.h	25.84 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_ldap.h	17.94 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_md5.h	2.12 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_mutex.h	9.07 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_script.h	9.63 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_time.h	4.10 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_varbuf.h	8.09 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_xml.h	1.31 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive