Função GetNtmsObjectSecurity (ntmsapi.h)

  • Artigo

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

A função GetNtmsObjectSecurity lê o descritor de segurança do objeto RSM especificado.

Sintaxe

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

Manipule para a sessão retornada pela função OpenNtmsSession .

[in] lpObjectId

Identificador exclusivo do objeto RSM.

[in] dwType

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

[in] RequestedInformation

Um valor SECURITY_INFORMATION que especifica os dados de segurança solicitados.

[out] lpSecurityDescriptor

Ponteiro para uma estrutura SECURITY_DESCRIPTOR que recebe o descritor de segurança.

[in] nLength

Comprimento do descritor.

[out] lpnLengthNeeded

Comprimento necessário do buffer se ele não for grande o suficiente para o descritor de segurança, em bytes.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 READ_CONTROL acesso ao objeto é negado.

Windows XP: Nenhum direito de acesso é necessário.
ERROR_DATABASE_FAILURE
 O banco de dados está inacessível ou danificado.
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 esse objeto.
ERROR_OBJECT_NOT_FOUND
 A ID do objeto não é válida.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

A segurança do RSM usa os descritores de segurança padrão e os membros de informações. Isso permite que as caixas de diálogo de segurança padrão sejam usadas para selecionar a segurança do RSM. 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

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

Funções de gerenciamento de objetos

SetNtmsObjectSecurity