Función SetNtmsMediaComplete (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 SetNtmsMediaComplete marca un fragmento de medio lógico como completo.

Sintaxis

DWORD SetNtmsMediaComplete(
  [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 lógicos.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_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.

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á en el estado asignado o está montado actualmente.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

La función SetNtmsMediaComplete marca el medio especificado como Completado. Una aplicación marca el medio como Completado cuando la aplicación ya no va a escribir en el medio. Los medios completos no se pueden montar con la marca NTMS_MOUNT_WRITE.

La función SetNtmsMediaComplete se usa normalmente cuando una aplicación llega al final del medio. Los medios montados o en uso no se pueden marcar como completos.

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

MountNtmsMedia