Função DismountNtmsDrive (ntmsapi.h)
[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 |
|---|---|
|
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. |
|
O banco de dados está inacessível ou danificado. |
|
O banco de dados está cheio. |
|
A unidade ou biblioteca não está habilitada. |
|
A ID da unidade não é válida. |
|
O identificador de sessão está ausente ou não é válido. |
|
A biblioteca da unidade não é válida. |
|
A ID da unidade está ausente. |
|
A unidade não contém mídia. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
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 |