Share via

IWMDMRevoked::GetRevocationURL

  • Article
banner art

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 where the revocation URL will be written.

pdwBufferLen

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

pdwRevokedBitFlag

[out]  Pointer to a DWORD containing information on what component(s) have been revoked. PdwRevokedBitFlag will be a value combining one or more of the following values using 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 and service provider 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 a complete 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

IMDMRevoked::GetRevocationURL retrieves the URL from which updated components can be downloaded. If this method is not implemented by the revoked component, a default Microsoft URL will be 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 wmdm.idl.

Library: mssachlp.lib

See Also