通过

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
 媒体池 ID 缺失或无效。
ERROR_INVALID_PARAMETER
 参数缺失或无效。
ERROR_NOT_ENOUGH_MEMORY
 内存分配失败。
ERROR_SUCCESS
 函数成功。

注解

注意

ntmsapi.h 标头将 GetNtmsMediaPoolName 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntmsapi.h
Library Ntmsapi.lib
DLL Ntmsapi.dll

另请参阅

CreateNtmsMediaPool

媒体服务函数