AtlGetSecurityDescriptor

Llame a esta función para recuperar el descriptor de seguridad de un objeto determinado.

Importante
Esta función no se puede utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.

inline bool AtlGetSecurityDescriptor(
LPCTSTR pszObjectName,
SE_OBJECT_TYPE ObjectType,
CSecurityDesc * pSecurityDescriptor,
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION | 
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges= true
) throw(...);

Parámetros

• pszObjectName
  Puntero a una cadena terminada en null que especifica el nombre de objeto del que recuperar información de seguridad.

• ObjectType
  Especifica un valor de enumeración de SE_OBJECT_TYPE que indica el tipo de objeto identificado por el parámetro de pszObjectName .

• pSecurityDescriptor
  El objeto que recibe el descriptor de seguridad solicitado.

• requestedInfo
  Un conjunto de marcadores de bits de SECURITY_INFORMATION que indican el tipo de información de seguridad se va a recuperar.Este parámetro puede ser una combinación de los siguientes valores.

• bRequestNeededPrivileges
  Si es true, la función intentará habilitar el privilegio de SE_SECURITY_NAME, y se restaura en la finalización.

Valor devuelto

Devuelve true si la operación se realiza correctamente; de lo contrario, devuelve false.

Comentarios

Si se va AtlGetSecurityDescriptor a llamar varias veces en varios objetos, será más eficaz habilitar el privilegio de SE_SECURITY_NAME una vez antes de llamar a la función, con bRequestNeededPrivileges establecido en false.

Requisitos

encabezado: atlsecurity.h

Vea también

Otros recursos

Funciones globales de seguridad