Funzione GetNtmsMediaPoolNameA (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La funzione GetNtmsMediaPoolName recupera la gerarchia completa del nome completo del pool multimediale specificato.
Sintassi
DWORD GetNtmsMediaPoolNameA(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpPoolId,
[out] LPSTR lpNameBuf,
[in, out] LPDWORD lpdwBufSize
);
Parametri
[in] hSession
Handle alla sessione restituita dalla funzione OpenNtmsSession .
[in] lpPoolId
Identificatore univoco del pool multimediale il cui nome deve essere recuperato.
[out] lpNameBuf
Puntatore a un buffer che riceve il nome del pool di supporti.
[in, out] lpdwBufSize
Dimensioni del buffer lpBufName , in input. Nell'output il numero di caratteri nella gerarchia del nome completo.
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Le dimensioni del buffer non sono sufficienti. La dimensione corretta viene restituita in lpdwBufSize. |
|
Il valore specificato nel parametro hSession è NULL o non è valido. |
|
L'ID del pool multimediale è mancante o non è valido. |
|
Il parametro non è valido o non è valido. |
|
L'allocazione della memoria non è riuscita. |
|
La funzione ha avuto esito positivo. |
Commenti
Nota
L'intestazione ntmsapi.h definisce GetNtmsMediaPoolName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |