Share via

Windows Media Player 11 SDK IWMPContentPartner::Login 

  • Article

Windows Media Player SDK banner art

Previous Next

IWMPContentPartner::Login

Note This section describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The Login method signs the user in to the online store.

Syntax

  HRESULT Login(
  BLOB  userInfo,
  BLOB  pwdInfo,
  VARIANT_BOOL  fUsedCachedCreds,
  VARIANT_BOOL  fOkToCache
);

Parameters

userInfo

[in]  Encrypted BLOB containing the user name.

pwdInfo

[in]  Encrypted BLOB containing the user password.

fUsedCachedCreds

[in]  VARIANT_BOOL indicating whether the plug-in should try to use cached credentials.

fOkToCache

[in]  VARIANT_BOOL indicating whether the plug-in is permitted to cache the supplied credentials.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

Usually, this method is called in response to a specific request by the user to sign in to the online store. Sometimes, the need to sign in is implied by other user actions, such as burning a music file that requires an updated license.

The plug-in must call IWMPContentPartnerCallback::Notify to notify Windows Media Player when the sign-in state changes.

To decrypt the user name and password, use the CryptUnprotectData function. CryptUnprotectData is documented in the Cryptography section of the Platform SDK. You must use the CRYPTPROTECT_UI_FORBIDDEN flag in the dwFlags parameter of CryptUnprotectData. Set the optional and reserved parameters to NULL.

Requirements

Version: Windows Media Player 11

Header: contentpartner.h

See Also

Previous Next