Función ZwQuerySecurityObject (ntifs.h)
La rutina ZwQuerySecurityObject recupera una copia del descriptor de seguridad de un objeto.
Sintaxis
NTSYSAPI NTSTATUS ZwQuerySecurityObject(
[in] HANDLE Handle,
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in] ULONG Length,
[out] PULONG LengthNeeded
);
Parámetros
[in] Handle
Identificador del objeto cuyo descriptor de seguridad se va a consultar. Este identificador debe tener el acceso especificado en la columna Significado de la tabla que se muestra en la descripción del parámetro SecurityInformation .
[in] SecurityInformation
Valor de SECURITY_INFORMATION que especifica la información que se va a consultar como una combinación de uno o varios de los siguientes.
| Valor | Significado |
|---|---|
| OWNER_SECURITY_INFORMATION | Se está consultando el identificador de propietario del objeto. Requiere acceso READ_CONTROL. |
| GROUP_SECURITY_INFORMATION | Se está consultando el identificador del grupo principal del objeto. Requiere acceso READ_CONTROL. |
| SACL_SECURITY_INFORMATION | Se está consultando la ACL del sistema del objeto (SACL). Requiere acceso ACCESS_SYSTEM_SECURITY. |
| DACL_SECURITY_INFORMATION | Se está consultando la lista de control de acceso discrecional (DACL) del objeto. Requiere acceso READ_CONTROL. |
[out] SecurityDescriptor
Búfer asignado por el llamador que ZwQuerySecurityObject rellena con una copia del descriptor de seguridad especificado. La estructura SECURITY_DESCRIPTOR se devuelve en formato auto relativo.
[in] Length
Tamaño, en bytes, del búfer al que apunta SecurityDescriptor.
[out] LengthNeeded
Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes necesarios para almacenar el descriptor de seguridad copiado.
Valor devuelto
ZwQuerySecurityObject devuelve STATUS_SUCCESS o un estado de error adecuado. Entre los posibles códigos de estado de error se incluyen los siguientes:
| Código devuelto | Descripción |
|---|---|
| STATUS_ACCESS_DENIED | El identificador no tenía el acceso necesario. |
| STATUS_BUFFER_TOO_SMALL | El búfer es demasiado pequeño para el descriptor de seguridad. Ninguna de las informaciones de seguridad se copió en el búfer. |
| STATUS_INVALID_HANDLE | Handle no era un identificador válido. |
| STATUS_OBJECT_TYPE_MISMATCH | Handle no era un identificador del tipo esperado. |
Comentarios
Un descriptor de seguridad puede estar en forma absoluta o relativa. En forma auto-relativa, todos los miembros de la estructura se encuentran contiguamente en la memoria. En forma absoluta, la estructura solo contiene punteros a los miembros. Para obtener más información, consulte Descriptores de seguridad absolutos y Self-Relative.
El sistema de archivos NTFS impone un límite de 64 K sobre el tamaño del descriptor de seguridad que se escribe en el disco para un archivo. (El sistema de archivos FAT no admite descriptores de seguridad para archivos). Por lo tanto, se garantiza que un búfer SecurityDescriptor de 64K es lo suficientemente grande como para contener la estructura de SECURITY_DESCRIPTOR devuelta.
Para obtener más información sobre la seguridad y el control de acceso, consulte Modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.
Los minifiltros deben llamar a FltQuerySecurityObject en lugar de ZwQuerySecurityObject.
Nota
Si la llamada a la función ZwQuerySecurityObject se produce en modo de usuario, debe usar el nombre "NtQuerySecurityObject" en lugar de "ZwQuerySecurityObject".
En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |