Função DeleteNtmsMedia (ntmsapi.h)
[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 DeleteNtmsMedia exclui uma parte física da mídia offline do RSM removendo todas as referências à mídia especificada do banco de dados.
Sintaxe
DWORD DeleteNtmsMedia(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaId
);
Parâmetros
[in] hSession
Identificador para a sessão retornada pela função OpenNtmsSession .
[in] lpMediaId
Identificador exclusivo de uma parte da mídia física.
Retornar valor
Essa função retorna um dos valores a seguir.
| Valor | Significado |
|---|---|
|
NTMS_MODIFY_ACCESS para o computador ou o pool de mídia da mídia é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
Windows XP: NTMS_MODIFY_ACCESS ao pool de mídia da mídia é negada. 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. |
|
O identificador de sessão está ausente ou não é válido. |
|
O identificador de mídia não é válido. |
|
O pool de mídia para a mídia não é válido. |
|
O identificador de mídia está ausente. |
|
A mídia não está offline. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
A função foi bem-sucedida. |
Comentários
A mídia especificada pela função DeleteNtmsMedia deve estar localizada em uma biblioteca offline e não ter um lado nos estados Alocado, Concluído ou Reservado.
Você pode usar DeleteNtmsMedia para remover mídia perdida ou destruída.
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 |