Función ORCreateKey
Crea la clave del Registro especificada en un subárbol del Registro sin conexión. Si la clave ya existe, la función la abre.
Sintaxis
DWORD ORCreateKey(
_In_ ORHKEY Handle,
_In_ PCWSTR lpSubKey,
_In_opt_ PWSTR lpClass,
_In_opt_ DWORD dwOptions,
_In_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
_Out_ PORHKEY phkResult,
_Out_opt_ PDWORD pdwDisposition
);
Parámetros
-
Identificador [in]
-
Identificador de una clave del Registro abierta en un subárbol del Registro sin conexión.
-
lpSubKey [in]
-
Puntero a una cadena Unicode que contiene el nombre de una subclave que esta función abre o crea. El parámetro lpSubKey debe especificar una subclave de la clave identificada por el parámetro Handle ; puede ser de hasta 32 niveles en profundidad en el árbol del Registro. Para obtener más información sobre los nombres de clave, vea Estructura del Registro.
Este parámetro no puede ser NULL.
Los nombres de clave no distinguen mayúsculas de minúsculas.
-
lpClass [in, optional]
-
Clase (tipo de objeto) de esta clave. Este parámetro se puede ignorar. Este parámetro puede ser NULL.
-
dwOptions [in, optional]
-
Este parámetro puede ser 0 o uno de los valores siguientes.
Value Significado - REG_OPTION_CREATE_LINK
- 0x00000002L
La clave es un vínculo simbólico. La ruta de acceso de destino se asigna al valor L"SymbolicLinkValue" de la clave. La ruta de acceso de destino debe ser una ruta de acceso absoluta del Registro. Si se establece esta opción, también se debe establecer REG_OPTION_NON_VOLATILE.
Si el parámetro lpSubKey especifica una clave existente, debe haberse creado con REG_OPTION_CREATE_LINK.
Los vínculos simbólicos del Registro solo se deben usar cuando sea absolutamente necesario para la compatibilidad de aplicaciones.- REG_OPTION_NON_VOLATILE
- 0x00000000L
La clave no es volátil; este es el valor predeterminado. La información se almacena en un archivo y se conserva cuando se reinicia el sistema. La función ORSaveHive guarda las claves que no son volátiles. -
pSecurityDescriptor [in, optional]
-
Puntero a una estructura de SECURITY_DESCRIPTOR que contiene un descriptor de seguridad para la nueva clave. Si pSecurityDescriptor es NULL, la clave obtiene un descriptor de seguridad predeterminado. Las ACL de un descriptor de seguridad predeterminado para una clave se heredan de su clave primaria directa.
-
phkResult [out]
-
Puntero que apunta a una variable que recibe un identificador de la clave abierta o creada. Use la función ORCloseKey para cerrar la clave una vez que haya terminado de usar el identificador .
-
pdwDisposition [out, optional]
-
Puntero a una variable que recibe uno de los siguientes valores de disposición.
Value Significado - REG_CREATED_NEW_KEY
- 0x00000001L
La clave no existía y se creó. - REG_OPENED_EXISTING_KEY
- 0x00000002L
La clave existía y simplemente se abrió sin cambiarse. Si pdwDisposition es NULL, no se devuelve información de disposición.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.
Si el parámetro dwOptions se establece con REG_OPTION_CREATE_LINK pero REG_OPTION_NON_VOLATILE está claro, o si el identificador que se va a devolver sería un identificador para la clave raíz del subárbol, la función devuelve ERROR_INVALID_PARAMETER.
Comentarios
La clave que crea la función ORCreateKey no tiene valores. Una aplicación puede usar la función ORSetValue para establecer valores de clave.
La función ORCreateKey no se puede usar para crear la clave raíz en un subárbol del Registro sin conexión. Use la función ORCreateHive para crear la clave raíz y obtener un identificador para la clave.
El registro sin conexión no admite guardar claves individuales. Use la función ORSaveHive para guardar una clave y sus subclaves en un subárbol.
Requisitos
| Requisito | Value |
|---|---|
| Redistribuible |
Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior |
| Encabezado |
|
| Archivo DLL |
|
Consulte también