Função EnableNtmsObject (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 EnableNtmsObject habilita o objeto especificado.

Sintaxe

DWORD EnableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Parâmetros

[in] hSession

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

[in] dwType

Tipo de objeto RSM. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração NtmsObjectsTypes .

Valor Significado
NTMS_DRIVE
 Unidade
NTMS_LIBRARY
 Biblioteca
NTMS_PHYSICAL_MEDIA
 Mídia física (fita, disco óptico, CD ou cartucho de disco magnético)

[in] lpObjectId

Identificador exclusivo do objeto RSM.

Valor retornado

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS à biblioteca que contém o objeto é negado. Outros erros de segurança são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: NTMS_CONTROL_ACCESS à biblioteca que contém o objeto é negado. Outros erros de segurança são possíveis, mas indicam um erro de subsistema de segurança.
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 ou o tipo de objeto não é válido. (O tipo de objeto não será válido se não for NTMS_LIBRARY, NTMS_DRIVE ou NTMS_PHYSICAL_MEDIA.)
ERROR_INVALID_STATE
 O objeto já está habilitado.
ERROR_LIBRARY_OFFLINE
 A ID da biblioteca refere-se a uma biblioteca off-line que não pode ser habilitada ou desabilitada.
ERROR_OBJECT_NOT_FOUND
 O objeto não é válido.
ERROR_SUCCESS
 A habilitação está na fila.

Comentários

A função EnableNtmsObject enfileira um comando de desabilitar com o RSM. Se o RSM estiver ocupado, o comando poderá levar algum tempo para ser concluído.

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

DisableNtmsObject

Funções de gerenciamento de objetos