Settings.requestMediaAccessRights 方法

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

requestMediaAccessRights 方法请求对库的指定级别的访问权限。

语法

bRetVal = Settings.requestMediaAccessRights(
  access
)

参数

access [in]

指定所需访问权限级别的字符串。 包含以下值之一。

String 描述
无 仅当前项访问权限。
读取 仅读取访问权限。
full 读/写访问权限。

返回值

此方法返回一个 布尔 值，该值指示是否授予了请求的访问权限。

备注

网页必须首先请求用户的权限，以便从库读取信息或将数据写入库。 调用此方法会提示用户出现一个对话框，该对话框请求指定的权限级别。 这意味着，如果未授予适当的访问权限，则代码将无法访问某些方法、属性和事件。 可以使用 “设置”检索当前访问权限级别。mediaAccessRights。

Windows 媒体播放器 10 Mobile：此方法始终返回 true。

要求

要求 值
版本
 Windows Media Player 9 系列或更高版本。
DLL
Wmp.dll

另请参阅

Settings 对象

Settings.mediaAccessRights