Funzione SwapNtmsMedia (ntmsapi.h)

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione SwapNtmsMedia scambia i lati associati ai due LMID specificati. Gli LMID specificati devono trovarsi nello stesso pool multimediale.

Sintassi

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

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId1

Identificatore univoco di un elemento multimediale logico (LMID).

[in] lpMediaId2

Identificatore univoco di un elemento multimediale logico (LMID).

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS al pool di supporti di entrambi i supporti viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_BAD_FORMAT	Nessuna libreria di etichette multimediali riconosce l'etichetta multimediale.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è completo.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_MEDIA	Almeno uno degli ID multimediali non è valido.
ERROR_INVALID_MEDIA_POOL	Uno o più pool di supporti per i supporti logici non sono validi.
ERROR_INVALID_PARAMETER	Almeno un identificatore multimediale è mancante.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

La funzione SwapNtmsMedia viene usata per aggiornare i supporti fisici senza influire sull'applicazione.

Il supporto per entrambi gli LMID non deve essere usato per la riuscita di questa funzione.

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll