Función ORGetKeySecurity

Recupera una copia del descriptor de seguridad que protege la clave del Registro abierta especificada en un subárbol del Registro sin conexión.

Sintaxis

DWORD ORGetKeySecurity(
  _In_      ORHKEY               Handle,
  _In_      SECURITY_INFORMATION SecurityInformation,
  _Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Inout_   PDWORD               lpcbSecurityDescriptor
);

Parámetros

Identificador [in]

Identificador de una clave del Registro abierta en un subárbol del registro sin conexión.

SecurityInformation [in]

Valor de SECURITY_INFORMATION que indica la información de seguridad solicitada.

pSecurityDescriptor [out, opcional]

Puntero a un búfer que recibe una copia del descriptor de seguridad solicitado. Este parámetro puede ser NULL.

lpcbSecurityDescriptor [in, out]

Puntero a una variable que especifica el tamaño, en bytes, del búfer al que apunta el parámetro pSecurityDescriptor . Cuando se devuelve la función, la variable contiene el número de bytes escritos en el búfer.

Valor devuelto

Si la función se realiza correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la función, devuelve 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 búfer especificado por el parámetro pSecurityDescriptor es demasiado pequeño, la función devuelve ERROR_INSUFFICIENT_BUFFER y el parámetro lpcbSecurityDescriptor contiene el número de bytes necesarios para el descriptor de seguridad solicitado.

Requisitos

Consulte también

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION