Share via

Função DismountNtmsDrive (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 DismountNtmsDrive enfileira um comando para mover a mídia na unidade especificada para o slot de armazenamento. Essa função deve ser emparelhada com a função MountNtmsMedia .

Sintaxe

DWORD DismountNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Parâmetros

[in] hSession

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

[in] lpDriveId

Identificador exclusivo de um objeto de unidade.

Retornar valor

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

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

Windows XP: NTMS_CONTROL_ACCESS para a biblioteca é negado. 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
 A unidade ou biblioteca não está habilitada.
ERROR_INVALID_DRIVE
 A ID da unidade não é válida.
ERROR_INVALID_HANDLE
 O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_LIBRARY
 A biblioteca da unidade não é válida.
ERROR_INVALID_PARAMETER
 A ID da unidade está ausente.
ERROR_INVALID_STATE
 A unidade não contém mídia.
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

Se a unidade especificada pela função DismountNtmsDrive estiver vazia ou se a mídia estiver aberta, um erro será retornado. Caso contrário, a mídia será retornada para seu slot.

Desmontar solicitações para unidades autônomas colocam a unidade no estado desmontável e retornam êxito.

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 de controle de biblioteca