IWMDMRevoked::GetRevocationURL (deprecated)

  • Article
banner art

This is preliminary documentation and subject to change.

This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.

The GetRevocationURL method retrieves the URL from which updated components can be downloaded.

Syntax

HRESULT GetRevocationURL(
  LPWSTR*  ppwszRevocationURL,
  DWORD*  pdwBufferLen,
  DWORD*  pdwRevokedBitFlag
);

Parameters

ppwszRevocationURL

[in, out]  Pointer to a string containing a revocation URL. This buffer is created and freed by the caller.

pdwBufferLen

[in, out]  Size of the buffer holding the revocation URL.

pdwRevokedBitFlag

[out]  Pointer to a DWORD specifying information on what component(s) have been revoked. This should be one or more of the following values, combined using a bitwise OR*.*

Flag Description
WMDM_WMDM_REVOKED Windows Media Device Manager itself has been revoked.
WMDM_APP_REVOKED The application has been revoked and needs to be updated before any DRM-protected content can be transferred.
WMDM_SP_REVOKED The service provider has been revoked and needs to be updated before any DRM-protected content can be transferred to it.
WMDM_SCP_REVOKED The secured content provider has been revoked and needs to be updated before any DRM-protected content can be transferred.

Return Values

The method returns an HRESULT. All the interface methods in Windows Media Device Manager can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes

For an extenstive list of possible error codes, see Error Codes.

Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_INVALIDTYPE The object with which this interface is associated is not a playable file or folder.
WMDM_E_NOTSUPPORTED This device does not support setting play lengths.
E_FAIL An unspecified error occurred.

Remarks

This method retrieves the URL from which updated components can be downloaded. If this method is not implemented by the revoked component, a default Microsoft URL is used. This location is maintained by Microsoft and contains any updates to components revoked by the Microsoft digital rights management system.

Requirements

Header: Defined in mswmdm.h.

Library: mssachlp.lib

See Also