Funzione GetNtmsMediaPoolNameW (ntmsapi.h)

Articolo
11/20/2024

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

La funzione GetNtmsMediaPoolName recupera la gerarchia dei nomi completi del pool di supporti specificato.

Sintassi

DWORD GetNtmsMediaPoolNameW(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPWSTR      lpNameBuf,
  [in, out] LPDWORD     lpdwBufSize
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpPoolId

Identificatore univoco del pool di supporti 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 all'input. Nell'output il numero di caratteri nella gerarchia dei nomi completi.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer non sono sufficienti. La dimensione corretta viene restituita in lpdwBufSize.
ERROR_INVALID_HANDLE	Il valore specificato nel parametro hSession è NULL o non è valido.
ERROR_INVALID_MEDIA_POOL	L'ID del pool di supporti è mancante o non è valido.
ERROR_INVALID_PARAMETER	Il parametro è mancante o non è valido.
ERROR_NOT_ENOUGH_MEMORY	Allocazione di memoria non riuscita.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ntmsapi.h
libreria	Ntmsapi.lib
dll	Ntmsapi.dll

Vedere anche

CreateNtmsMediaPool

Funzioni di Servizi multimediali

Condividi tramite