Функция GetNtmsMediaPoolNameA (ntmsapi.h)

  • Статья

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Функция GetNtmsMediaPoolName извлекает иерархию полных имен указанного пула носителей.

Синтаксис

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

Параметры

[in] hSession

Дескриптор сеанса, возвращаемого функцией OpenNtmsSession .

[in] lpPoolId

Уникальный идентификатор пула носителей, имя которого требуется извлечь.

[out] lpNameBuf

Указатель на буфер, получающий имя пула носителей.

[in, out] lpdwBufSize

Размер буфера lpBufName на входе. В выходных данных — количество символов в иерархии полных имен.

Возвращаемое значение

Эта функция возвращает одно из следующих значений.

Значение Значение
ERROR_INSUFFICIENT_BUFFER
 Размер буфера недостаточно велик. Правильный размер возвращается в lpdwBufSize.
ERROR_INVALID_HANDLE
 Значение, указанное в параметре hSession , равно NULL или недопустимо.
ERROR_INVALID_MEDIA_POOL
 Идентификатор пула носителей отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Параметр отсутствует или недопустим.
ERROR_NOT_ENOUGH_MEMORY
 Не удалось выделить память.
ERROR_SUCCESS
 Функция выполнена успешно.

Комментарии

Примечание

Заголовок ntmsapi.h определяет GetNtmsMediaPoolName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntmsapi.h
Библиотека Ntmsapi.lib
DLL Ntmsapi.dll

См. также раздел

CreateNtmsMediaPool

Функции служб мультимедиа