Função DismountNtmsMedia (ntmsapi.h)

  • Artigo

[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 DismountNtmsMedia enfileira um comando para mover a mídia especificada em uma unidade para seu armazenamento. Essa função deve ser emparelhada com a função MountNtmsMedia .

Sintaxe

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

Parâmetros

[in] hSession

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

[in] lpMediaId

Matriz de pelo menos um meio lógico ou lado.

[in] dwCount

Número de identificadores de mídia no parâmetro lpMediaId .

[in] dwOptions

Opções. Esse parâmetro pode ser o valor a seguir.

Valor Significado
NTMS_DISMOUNT_DEFERRED
 Marca o estado da mídia como Desmontável e mantém o meio na unidade. As solicitações de montagem subsequentes são atendidas usando unidades desmontadas ou desmontáveis. O padrão é desmontar imediatamente.
NTMS_DISMOUNT_IMMEDIATE
 Desmonte a unidade imediatamente.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS ao pool de mídia ou à biblioteca que contém a mídia é negada. Outros erros de segurança também 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_DATABASE_FULL
 O banco de dados está cheio.
ERROR_DEVICE_NOT_AVAILABLE
 Um ou mais recursos necessários para executar a desmontagem não estão disponíveis no momento (provavelmente desabilitados).
ERROR_INVALID_LIBRARY
 A biblioteca que contém a mídia não é válida.
ERROR_INVALID_MEDIA
 Pelo menos uma das mídias especificadas não é válida.
ERROR_INVALID_STATE
 Ocorreu um estado inesperado de mídia ou dispositivo durante a desmontagem.
ERROR_MEDIA_OFFLINE
 A mídia especificada está offline.
ERROR_MEDIA_NOT_AVAILABLE
 Um ou mais recursos de mídia necessários para executar a montagem não estão disponíveis no momento (provavelmente desabilitados).
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação de memória durante o processamento.
ERROR_SUCCESS
 A desmontagem de mídia foi enfileirada.
ERROR_TIMEOUT
 O evento de tempo limite expirou enquanto o aplicativo tentava adquirir um ou mais recursos.

Comentários

Um aplicativo deve usar a função DismountNtmsMedia para liberar o recurso de unidade depois que o aplicativo tiver usado o meio especificado. A mídia não lançada não pode ser usada por outras sessões RSM.

A função DismountNtmsMedia retorna assim que a operação é enfileirada com o RSM. O aplicativo pode aguardar o estado lateral ficar ocioso.

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

Funções dos Serviços de Mídia

MountNtmsMedia