Función DeleteNtmsMedia (ntmsapi.h)

  • Artículo

[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