Función ORDeleteKey
Elimina una subclave y sus valores de un subárbol del Registro sin conexión.
Sintaxis
DWORD ORDeleteKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKey
);
Parámetros
-
Identificador [in]
-
Identificador de una clave del Registro abierta en un subárbol del Registro sin conexión. La función ORCreateKey o OROpenKey devuelve este identificador.
-
lpSubKey [in, optional]
-
El nombre de la clave que se va a eliminar. Debe ser una subclave de la clave que Handle identifica, pero no puede tener subclaves.
Si la subclave no existe, la función devuelve ERROR_NOT_FOUND.
Si este parámetro es NULL, la función elimina la clave especificada por el parámetro Handle . Si la clave especificada por el parámetro Handle es la clave raíz del subárbol, la función devuelve ERROR_INVALID_PARAMETER.
Los nombres de clave no distinguen mayúsculas de minúsculas.
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. Entre los posibles códigos de error se incluyen los siguientes:
- Si la subclave especificada no existe, la función devuelve ERROR_FILE_NOT_FOUND.
- Si la subclave especificada es la clave raíz del subárbol del Registro, la función devuelve ERROR_INVALID_PARAMETER.
- Si la subclave especificada tiene subclaves, la función devuelve ERROR_KEY_HAS_CHILDREN.
Observaciones
Si existe la clave del Registro especificada, se marca como eliminada. No se quita una clave eliminada hasta que se cierra el último identificador.
La clave que se va a eliminar no debe tener subclaves. Para eliminar una clave y todas sus subclaves, use la función OREnumKey para enumerar las subclaves y eliminarlas individualmente.
Solo se puede llamar a la función ORCloseKey en una clave eliminada; Se produce un error en todas las demás operaciones del Registro sin conexión. Si la clave eliminada se creó explícitamente llamando a ORCreateKey, los recursos asociados a la clave se liberan cuando se cierra el último identificador de la clave eliminada.
Requisitos
| Requisito | Value |
|---|---|
| Redistribuible |
Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior |
| Encabezado |
|
| Archivo DLL |
|
Consulte también