Função SwapNtmsMedia (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 SwapNtmsMedia troca os lados associados aos dois LMIDs especificados. Os LMIDs especificados devem estar no mesmo pool de mídia.

Sintaxe

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

[in] hSession

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

[in] lpMediaId1

Identificador exclusivo de uma LMID (mídia lógica).

[in] lpMediaId2

Identificador exclusivo de uma LMID (mídia lógica).

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

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS para o pool de mídia de qualquer mídia é negada. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
ERROR_BAD_FORMAT	Nenhuma biblioteca de rótulos de mídia reconhece o rótulo de mídia.
ERROR_DATABASE_FAILURE	O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL	O banco de dados está cheio.
ERROR_INVALID_HANDLE	O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_MEDIA	Pelo menos uma das IDs de mídia não é válida.
ERROR_INVALID_MEDIA_POOL	Um ou mais pools de mídia para a mídia lógica não são válidos.
ERROR_INVALID_PARAMETER	Pelo menos um identificador de mídia está ausente.
ERROR_NOT_ENOUGH_MEMORY	Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS	A função foi bem-sucedida.

A função SwapNtmsMedia é usada para atualizar a mídia física sem afetar o aplicativo.

A mídia para ambos os LMIDs não deve estar em uso para que essa função tenha êxito.

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