Función DeleteNtmsMedia (ntmsapi.h)

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función DeleteNtmsMedia elimina un elemento físico de medios sin conexión de RSM quitando todas las referencias al medio especificado de la base de datos.

Sintaxis

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

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpMediaId

Identificador único de un elemento de medios físicos.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS al equipo o al grupo de medios se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad. Windows XP: NTMS_MODIFY_ACCESS al grupo de medios de comunicación se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_DATABASE_FAILURE	La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL	La base de datos está llena.
ERROR_INVALID_HANDLE	Falta el identificador de sesión o no es válido.
ERROR_INVALID_MEDIA	El identificador multimedia no es válido.
ERROR_INVALID_MEDIA_POOL	El grupo de medios para el medio no es válido.
ERROR_INVALID_PARAMETER	Falta el identificador multimedia.
ERROR_INVALID_STATE	El medio no está sin conexión.
ERROR_NOT_ENOUGH_MEMORY	Error de asignación durante el procesamiento.
ERROR_SUCCESS	La función se realizó correctamente.

Comentarios

Los medios especificados por la función DeleteNtmsMedia deben encontrarse en una biblioteca sin conexión y no tener un lado en los estados Asignado, Completado o Reservado.

Puede usar DeleteNtmsMedia para quitar medios perdidos o destruidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntmsapi.h
Library	Ntmsapi.lib
Archivo DLL	Ntmsapi.dll

Consulte también

Funciones de Media Services