Función GetNtmsObjectSecurity (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 GetNtmsObjectSecurity lee el descriptor de seguridad del objeto RSM especificado.

Sintaxis

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

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. Para obtener una lista de tipos de objeto, vea NtmsObjectsTypes.

[in] RequestedInformation

Valor de SECURITY_INFORMATION que especifica los datos de seguridad solicitados.

[out] lpSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR que recibe el descriptor de seguridad.

[in] nLength

Longitud del descriptor.

[out] lpnLengthNeeded

Longitud necesaria del búfer si no es lo suficientemente grande para el descriptor de seguridad, en bytes.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 READ_CONTROL se deniega el acceso al objeto.

Windows XP: No se requieren derechos de acceso.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
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

La seguridad de RSM usa los descriptores de seguridad estándar y los miembros de información. Esto permite usar los cuadros de diálogo de seguridad estándar para seleccionar seguridad de RSM. 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

Requisito Value
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

Funciones de administración de objetos

SetNtmsObjectSecurity