Função AddNtmsMediaType (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 AddNtmsMediaType adicionará o tipo de mídia especificado à biblioteca especificada se não houver atualmente uma relação no objeto de biblioteca. Em seguida, a função criará os pools de mídia do sistema se eles não existirem.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpMediaTypeId

Identificador exclusivo do tipo de mídia a ser adicionado à biblioteca.

[in] lpLibId

Identificador exclusivo da biblioteca à qual o tipo de mídia será adicionado.

Retornar valor

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

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS para a biblioteca é negado. Outros erros de segurança são possíveis, mas indicam um erro de subsistema de segurança. Windows XP: NTMS_CONTROL_ACCESS para a biblioteca é negado. 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_MEDIA	O tipo de mídia não é válido.
ERROR_INVALID_PARAMETER	O tipo de mídia ou a ID da biblioteca estão ausentes.
ERROR_NOT_ENOUGH_MEMORY	Houve uma falha de alocação durante o processamento.
ERROR_SUCCESS	A função foi bem-sucedida.

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

DeleteNtmsMediaType

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