Função DecommissionNtmsMedia (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 DecommissionNtmsMedia move um lado do estado Disponível para o estado Desativado.

Sintaxe

DWORD DecommissionNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

[in] hSession

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

[in] lpMediaId

Identificador exclusivo de um lado de um pedaço de mídia física.

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS para 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 para 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.
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	O identificador de mídia não é válido.
ERROR_INVALID_MEDIA_POOL	O pool de mídia para mídia não é válido.
ERROR_INVALID_PARAMETER	O identificador de mídia está ausente.
ERROR_INVALID_STATE	A mídia não está no estado Disponível.
ERROR_NOT_ENOUGH_MEMORY	Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS	A função foi bem-sucedida.

A mídia desativada pela função DecommissionNtmsMedia é reconhecida pelo RSM, mas a mídia desativada não contém nenhum dado e nunca mais é usada.

Somente a mídia que está no estado Disponível pode ser desativada. Para obter mais informações, consulte Ciclo de Vida da Mídia.

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