IMDSPStorageGlobals::GetSerialNumber 方法 (mswmdm.h)

GetSerialNumber 方法检索唯一标识存储介质的序列号。 必须为受保护的内容传输实现此方法,否则此方法是可选的。 有关详细信息,请参阅 必需接口和可选接口

.

语法

HRESULT GetSerialNumber(
  [out]     PWMDMID  pSerialNum,
  [in, out] BYTE [8] abMac
);

参数

[out] pSerialNum

指向包含序列号信息的 WMDMID 结构的指针。 此参数包含在输出消息身份验证代码中。

[in, out] abMac

包含此方法参数数据的消息身份验证代码的八个字节的数组。 (WMDM_MAC_LENGTH 定义为 8.)

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

并非所有存储媒体都支持序列号。 必须始终检查返回代码,以确定存储介质是否提供此支持。 如果存储介质不支持返回唯一序列号,则无法将受保护的内容传输到媒体。 如果表示的存储是可移动媒体,则返回的序列号必须是存储序列号,该序列号应不同于设备序列号。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPStorageGlobals 接口

WMDMID