Función SetNtmsObjectSecurity (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función SetNtmsObjectSecurity escribe el descriptor de seguridad para el objeto RSM especificado.

Sintaxis

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpObjectId

Identificador único del objeto RSM.

[in] dwType

Tipo de objeto RSM. Para obtener una lista de tipos de objeto, vea NtmsObjectsTypes.

[in] SecurityInformation

Valor de SECURITY_INFORMATION que especifica la información de seguridad que se va a escribir en el objeto RSM.

[in] lpSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR que especifica el descriptor de seguridad que se va a escribir en el objeto RSM: NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS o NTMS_MODIFY_ACCESS.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Se deniegan los privilegios necesarios para modificar el descriptor de seguridad.
ERROR_DATABASE_FAILURE
 La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 Falta el identificador de objeto.
ERROR_NO_SECURITY_ON_OBJECT
 No hay información de seguridad para este objeto.
ERROR_OBJECT_NOT_FOUND
 El identificador de objeto no es válido.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Si una aplicación usa SetNtmsObjectSecurity para establecer la lista de control de acceso discrecional (ACL) de un objeto, la aplicación debe tener WRITE_DAC permiso o ser el propietario del objeto.

Si una aplicación usa SetNtmsObjectSecurity para establecer la ACL del sistema de un objeto, el privilegio SE_SECURITY_NAME debe estar habilitado para la aplicación. Para obtener más información, vea la función SetPrivateObjectSecurity . Para más información sobre la seguridad de RSM, consulte Seguridad de RSM.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

EnumerateNtmsObject

GetNtmsObjectSecurity

Funciones de administración de objetos