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

Статья
11/20/2024

[Диспетчер съемных носителей больше не доступен в 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

Обработка сеанса, возвращаемого функцией OpenNtmsSess ion.

[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 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntmsapi.h
библиотеки	Ntmsapi.lib
DLL	Ntmsapi.dll

См. также

CreateNtmsMediaPool

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

Поделиться через