Função DisableNtmsObject (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 DisableNtmsObject desabilita o objeto RSM especificado.

Sintaxe

DWORD DisableNtmsObject(
  [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 magnético)

[in] lpObjectId

Identificador exclusivo do objeto RSM.

Retornar valor

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
 Uma ID de 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á desabilitado.
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 desabilitação está na fila.

Comentários

A função DisableNtmsObject enfileira um comando de desabilitar para o objeto especificado. A função retorna com êxito quando o comando é enfileirado. Se o RSM estiver ocupado, o comando poderá levar algum tempo para ser concluído. Quando o meio é desabilitado, o RSM renderiza todos os lados da mídia e a mídia lógica associada indisponíveis. Todas as solicitações para mídia desabilitada retornam erros.

Para remover uma unidade ou um alterador de mídia do serviço, a unidade ou o alterador de mídia deve primeiro ser desabilitado.

Todos os objetos contidos por um objeto desabilitado também estão desabilitados. Por exemplo, desabilitar uma parte da mídia física desabilita todos os lados. Sempre que possível, quando uma unidade é desabilitada, a média na unidade é removida e colocada em seu slot.

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

EnableNtmsObject

Funções de gerenciamento de objetos