Função SetNtmsObjectSecurity (ntmsapi.h)

[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o Windows Server 2008 R2.]

A função SetNtmsObjectSecurity grava o descritor de segurança para o objeto RSM especificado.

Sintaxe

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 para a sessão retornada pela função OpenNtmsSession .

[in] lpObjectId

Identificador exclusivo do objeto RSM.

[in] dwType

Tipo de objeto RSM. Para obter uma lista de tipos de objeto, consulte NtmsObjectsTypes.

[in] SecurityInformation

Um valor SECURITY_INFORMATION que especifica as informações de segurança a serem gravadas no objeto RSM.

[in] lpSecurityDescriptor

Ponteiro para uma estrutura SECURITY_DESCRIPTOR que especifica o descritor de segurança a ser gravado no objeto RSM: NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS ou NTMS_MODIFY_ACCESS.

Valor retornado

Essa função retorna um dos valores a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	Os privilégios necessários para modificar o descritor de segurança são negados.
ERROR_DATABASE_FAILURE	O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL	O banco de dados está cheio.
ERROR_INVALID_HANDLE	O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_PARAMETER	A ID do objeto está ausente.
ERROR_NO_SECURITY_ON_OBJECT	Não há informações de segurança para este objeto.
ERROR_OBJECT_NOT_FOUND	A ID do objeto não é válida.
ERROR_SUCCESS	A função foi bem-sucedida.

Comentários

Se um aplicativo usar SetNtmsObjectSecurity para definir a ACL (lista de controle de acesso) discricionária de um objeto, o aplicativo deverá ter WRITE_DAC permissão ou ser o proprietário do objeto.

Se um aplicativo usar SetNtmsObjectSecurity para definir a ACL do sistema de um objeto , o privilégio SE_SECURITY_NAME deverá ser habilitado para o aplicativo. Para obter mais informações, consulte a função SetPrivateObjectSecurity . Para obter mais informações sobre a segurança do RSM, consulte RSM Security.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntmsapi.h
Biblioteca	Ntmsapi.lib
DLL	Ntmsapi.dll

Confira também

EnumerateNtmsObject

GetNtmsObjectSecurity

Funções de gerenciamento de objetos