Funzione CreateNtmsMediaPool (ntmsapi.h)
[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.
[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 |
---|---|
|
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. |
|
Impossibile creare un nuovo pool multimediale perché esiste già con questo nome. |
|
Il database è inaccessibile o danneggiato. |
|
Il database è completo. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza. |
|
L'handle di sessione non è valido o non è valido. |
|
Il tipo di supporto selezionato non è valido. |
|
La sintassi del nome del pool non è valida. Il nome è troppo lungo. |
|
Il nome del pool multimediale o il puntatore ID del pool multimediale non è presente. |
|
Impossibile aprire il pool di supporti esistente. |
|
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 |