Funzione MoveToNtmsMediaPool (ntmsapi.h)

Articolo
08/25/2023

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

La funzione MoveToNtmsMediaPool sposta il supporto specificato dal pool multimediale corrente al pool multimediale specificato.

Sintassi

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

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco di un elemento multimediale fisico.

[in] lpPoolId

Identificatore univoco del pool di supporti di destinazione.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS al pool di supporti del supporto viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: NTMS_MODIFY_ACCESS al pool di supporti di origine o al pool di supporti di destinazione viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_BUSY	Almeno un lato del supporto è in uso o attualmente non disponibile.
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_POOL	Il pool di supporti di destinazione non è valido; il pool multimediale non è esistente; o il supporto nel pool di importazione o non riconosciuto può essere spostato solo nel pool gratuito.
ERROR_INVALID_MEDIA	Il pool di supporti di origine o di origine implicita non è valido.
ERROR_INVALID_PARAMETER	L'ID multimediale o l'ID del pool multimediale non è presente.
ERROR_MEDIA_INCOMPATIBLE	Il tipo di supporto dell'origine differisce dal tipo di supporto del pool di supporti di destinazione.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

Il pool di destinazione specificato nella funzione MoveToNtmsMediaPool deve essere dello stesso tipo di supporto e avere la sicurezza compatibile.

RSM scrive un identificatore multimediale nel supporto prima di spostare il supporto nel pool multimediale gratuito.

Uno stato medio con una partizione nello stato completato, allocato o riservato potrebbe non essere spostato nel pool di supporti gratuiti. Un supporto può essere spostato in un pool di importazione solo se tutte le partizioni del supporto si trovano nello stato Di importazione.

Windows Server 2003: Se il pool gratuito è il pool di origine, è necessario NTMS_USE_ACCESS al pool gratuito e NTMS_CONTROL_ACCESS al pool di destinazione. In caso contrario, NTMS_CONTROL_ACCESS è necessario sia nel pool di origine che in quello di destinazione. Se il pool gratuito è il pool di destinazione, è necessario NTMS_CONTROL_ACCESS al pool di origine e NTMS_USER_ACCESS al pool gratuito. In caso contrario, NTMS_CONTROL_ACCESS è necessario nei pool di origine e di destinazione.

Requisiti

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

Vedi anche

AllocateNtmsMedia

CreateNtmsMediaPool

Funzioni di Servizi multimediali

Condividi tramite