Compartilhar via

Função DeleteNtmsMediaType (ntmsapi.h)

  • Artigo

[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 DeleteNtmsMediaType exclui a relação de tipo de mídia especificada da biblioteca especificada, desde que a biblioteca não contenha nenhum objeto de mídia física do tipo de mídia especificado.

Sintaxe

DWORD DeleteNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

Parâmetros

[in] hSession

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

[in] lpMediaTypeId

Identificador exclusivo de um tipo de mídia a ser excluído de uma biblioteca.

[in] lpLibId

Identificador exclusivo da biblioteca da qual excluir o tipo de mídia.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS à biblioteca é negada. Outros erros de segurança são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: NTMS_CONTROL_ACCESS à biblioteca é negada. Outros erros de segurança 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_LIBRARY
 A ID da biblioteca não é válida.
ERROR_INVALID_PARAMETER
 O tipo de mídia ou a ID da biblioteca está ausente.
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

Se não houver objetos de mídia física do tipo de mídia especificado no sistema RSM e não houver objetos de biblioteca que contenham a relação de tipo de mídia especificada no sistema RSM, os pools de mídia do sistema para esse tipo de mídia serão excluídos. A incapacidade de excluir os pools de mídia do sistema não faz com que a função DeleteNtmsMediaType falhe.

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

AddNtmsMediaType

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