Funzione CreateNtmsMediaPool (ntmsapi.h)

Articolo
02/29/2024

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

La funzione CreateNtmsMediaPool crea un nuovo pool di supporti dell'applicazione.

Sintassi

DWORD CreateNtmsMediaPool(
  [in]  HANDLE                hSession,
  [in]  LPCTSTR               lpPoolName,
  [in]  LPNTMS_GUID           lpMediaType,
  [in]  DWORD                 dwAction,
  [in]  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out] LPNTMS_GUID           lpPoolId
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpPoolName

Nome del nuovo pool multimediale. I nomi del pool di supporti devono essere univoci nell'ambito di un singolo database RSM.

[in] lpMediaType

Identificatore per il tipo di supporto in questo pool multimediale. Usare la funzione EnumerateNtmsObject per ottenere un elenco di tipi di supporti disponibili e i relativi attributi. L'applicazione può passare un puntatore NULL per creare un pool di supporti che contiene solo altri pool multimediali.

[in] dwAction

Azione da eseguire. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
NTMS_OPEN_EXISTING	Apre un pool di supporti esistente in base al nome. Restituisce ERROR_OBJECT_NOT_FOUND se il pool non esiste.
NTMS_OPEN_ALWAYS	Apre un pool di supporti esistente o crea il pool se non esiste.
NTMS_CREATE_NEW	Crea un nuovo pool multimediale. Restituisce ERROR_ALREADY_EXISTS se il pool esiste.

[in] lpSecurityAttributes

Descrittore di sicurezza facoltativo usato per limitare l'accesso al pool.

[out] lpPoolId

Puntatore a una variabile che riceve l'identificatore univoco del pool multimediale dopo la creazione o l'apertura del pool multimediale.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS al pool radice o al pool multimediale padre viene negato durante il tentativo di creare un nuovo pool multimediale. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: NTMS_MODIFY_ACCESS al pool di supporti padre viene negato durante il tentativo di creare un nuovo pool di supporti. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_ALREADY_EXISTS	Impossibile creare un nuovo pool multimediale perché esiste già con questo nome.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è completo. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_MEDIA	Il tipo di supporto selezionato non è valido.
ERROR_INVALID_NAME	La sintassi del nome del pool non è valida. Il nome è troppo lungo.
ERROR_INVALID_PARAMETER	Il nome del pool multimediale o il puntatore ID del pool multimediale non è presente.
ERROR_OBJECT_NOT_FOUND	Impossibile aprire il pool di supporti esistente.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

I pool multimediali gratuiti, non riconosciuti e Import media pool vengono creati da RSM e non possono essere creati con la funzione CreateNtmsMediaPool .

I pool di supporti RSM sono organizzati come gerarchia separati dal carattere "". L'applicazione, free, unrecognized e import media pool esistono nella radice della gerarchia. RSM crea e gestisce i pool Free, Unrecognized e Import. RSM crea un pool di supporti gratuito per ogni tipo di supporto disponibile.

I pool di supporti specifici dell'applicazione vengono creati dalle applicazioni. Le applicazioni creano pool multimediali per il proprio uso nel pool di applicazioni radice. Questi pool multimediali hanno nomi simili al file system. Solo il punto finale del nome contiene supporti e criteri. Un'applicazione può definire pool come \MyApp\Pool1 e \MyApp\Pool2. In questo modo la gerarchia viene trasmessa all'interfaccia utente ed evita i nomi duplicati. Ogni livello di pool deve essere creato singolarmente; prima MyApp e pool1 e Pool2, molto simili a cartelle e file.

Windows Server 2003: Per creare un pool multimediale, è necessario avere NTMS_CONTROL_ACCESS nel pool radice e nel pool padre. Se non viene fornito un descrittore di sicurezza, il pool eredita gli ACL del pool padre (se il pool padre non è il pool radice). Inoltre, l'autore e gli account di sistema locali hanno accesso completo al pool. Se il pool padre è il pool radice, gli ACL non vengono ereditati; l'unico ACL nel daCL è l'accesso completo per l'autore e gli account di sistema locali.

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

DeleteNtmsMediaPool

GetNtmsObjectSecurity

Funzioni di Servizi multimediali

SetNtmsObjectSecurity

Condividi tramite