External.authenticate 方法

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

authenticate 方法启动对用户进行身份验证的尝试。

语法

External.authenticate(
  AuthenticationIndex
)

参数

AuthenticationIndex [in]

数字 (长) ，指定身份验证成功网页的索引。

返回值

此方法不返回值。

备注

发现页上的某些链接具有仅在用户进行身份验证后才应显示的目标。 发现页面、Windows 媒体播放器和在线商店的插件使用以下步骤对用户进行身份验证并显示目标网页：

1. 发现页上的脚本调用 External。authenticate 方法。
2. Windows 媒体播放器将显示一个对话框，用于获取用户名和密码。
3. Windows 媒体播放器调用 IWMPContentPartner：：Authenticate，这会启动身份验证尝试并立即返回。
4. 身份验证尝试完成后，在线商店的插件会调用 IWMPContentPartnerCallback：：Notify，传递 wmpcnAuthResult 和指示尝试是否成功的布尔值。
5. 如果身份验证尝试成功，Windows 媒体播放器调用 IWMPContentPartner：：GetItemInfo，传递g_szItemInfo_AuthenticationSuccessURL，以获取身份验证成功网页的 URL。 在此调用中，Windows 媒体播放器将发现页传递给 External的索引。authenticate 方法。
6. Windows 媒体播放器显示身份验证成功网页。

要求

要求	值
版本	Windows Media Player 11
DLL	Wmp.dll

另请参阅

类型 1 在线商店的外部对象

External.attemptLogin

External.userLoggedIn