Compartir a través de

Función SwapNtmsMedia (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 SwapNtmsMedia intercambia los lados asociados a los dos LMID especificados. Los LMID especificados deben estar en el mismo grupo de medios.

Sintaxis

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

Parámetros

[in] hSession

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

[in] lpMediaId1

Identificador único de un fragmento de medios lógicos (LMID).

[in] lpMediaId2

Identificador único de un fragmento de medios lógicos (LMID).

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 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_BAD_FORMAT
 Ninguna biblioteca de etiquetas multimedia reconoce la etiqueta multimedia.
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
 Al menos uno de los identificadores multimedia no es válido.
ERROR_INVALID_MEDIA_POOL
 Uno o varios grupos de medios para los medios lógicos no son válidos.
ERROR_INVALID_PARAMETER
 Falta al menos un identificador multimedia.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

La función SwapNtmsMedia se usa para actualizar medios físicos sin afectar a la aplicación.

Los medios de ambos LMID no deben estar en uso para que esta función se realice correctamente.

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

AllocateNtmsMedia

Funciones de Media Services