Función OROpenKey
Abre la clave del Registro especificada en un subárbol del Registro sin conexión.
Sintaxis
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
Parámetros
-
Identificador [in]
-
Identificador de una clave del Registro abierta en un subárbol del registro sin conexión.
-
lpSubKeyName [in, opcional]
-
Puntero a una cadena UNICODE que contiene el nombre de la clave del Registro que se va a abrir. Esta clave debe ser una subclave de la clave identificada por el parámetro Handle .
Los nombres de clave no distinguen mayúsculas de minúsculas.
Si este parámetro es NULL o un puntero a una cadena vacía, la función devuelve el mismo identificador que se pasó. Si la clave especificada por el parámetro Handle es la clave raíz del subárbol, la función devuelve ERROR_INVALID_PARAMETER.
Para obtener más información, vea Límites de tamaño de elemento del Registro.
-
phkResult [out]
-
Puntero a una variable que recibe un identificador de la clave abierta. Use la función ORCloseKey para cerrar la clave una vez que haya terminado de usar el identificador .
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 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.
Si la clave especificada se ha marcado como eliminada, esta función devuelve ERROR_KEY_DELETED.
Comentarios
La función OROpenKey no se puede usar para abrir la clave raíz en un subárbol del Registro sin conexión. Para obtener un identificador de la clave raíz de un subárbol, use la función OROpenHive para cargar el subárbol en la memoria.
Requisitos
| Requisito | Value |
|---|---|
| Redistribuible |
Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior |
| Encabezado |
|
| Archivo DLL |
|
Consulte también