IWMDMRevoked::GetRevocationURL method (mswmdm.h)

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

Syntax

HRESULT GetRevocationURL(
  [in, out] LPWSTR *ppwszRevocationURL,
  [in, out] DWORD  *pdwBufferLen,
  [out]     DWORD  *pdwRevokedBitFlag
);

Parameters

[in, out] ppwszRevocationURL

Pointer to a string containing a revocation URL. This buffer is created and freed by the caller.

[in, out] pdwBufferLen

Size of the buffer holding the revocation URL.

[out] pdwRevokedBitFlag

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 value

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 extensive list of possible error codes, see Error Codes.

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

Requirement	Value
Target Platform	Windows
Header	mswmdm.h
Library	Mssachlp.lib

See also

IWMDMRevoked Interface