Função MoveToNtmsMediaPool (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 MoveToNtmsMediaPool move o meio especificado de seu pool de mídia atual para o pool de mídia especificado.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpMediaId

Identificador exclusivo de uma parte da mídia física.

[in] lpPoolId

Identificador exclusivo do pool de mídia de destino.

Retornar valor

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

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 de origem ou o pool de mídia de destino é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
ERROR_BUSY
 Pelo menos um lado da mídia está em uso ou atualmente indisponível.
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_POOL
 O pool de mídia de destino não é válido; o pool de mídia é inexistente; ou a mídia no pool de importação ou não reconhecido só pode ser movida para o pool gratuito.
ERROR_INVALID_MEDIA
 A mídia de origem ou o pool de mídia de origem implícita não é válido.
ERROR_INVALID_PARAMETER
 A ID de mídia ou a ID do pool de mídia estão ausentes.
ERROR_MEDIA_INCOMPATIBLE
 O tipo de mídia da origem difere do tipo de mídia do pool de mídia de destino.
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

O pool de destino especificado na função MoveToNtmsMediaPool deve ser do mesmo tipo de mídia e ter segurança compatível.

O RSM grava um identificador na mídia antes de mover a mídia para o pool de mídia gratuito.

Um meio com uma partição no estado Concluído, Alocado ou Reservado pode não ser movido para o pool de mídia gratuito. Um meio poderá ser movido para um pool de importação somente se todas as partições do meio estiverem no estado Importar.

Windows Server 2003: Se o pool gratuito for o pool de origem, será necessário NTMS_USE_ACCESS para o pool gratuito e NTMS_CONTROL_ACCESS para o pool de destino. Caso contrário, NTMS_CONTROL_ACCESS será necessário no pool de origem e de destino. Se o pool gratuito for o pool de destino, será necessário NTMS_CONTROL_ACCESS para o pool de origem e NTMS_USER_ACCESS para o pool gratuito. Caso contrário, NTMS_CONTROL_ACCESS será necessário em pools de origem e de destino.

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

AllocateNtmsMedia

CreateNtmsMediaPool

Funções dos Serviços de Mídia