IMDSPRevoked::GetRevocationURL
.gif "banner art") |
The GetRevocationURL method retrieves the URL from which updated components can be downloaded.
Syntax
HRESULT GetRevocationURL(LPWSTR*ppwszRevocationURL,DWORD*pdwMaxChars);
Parameters
ppwszRevocationURL
[in, out] Pointer to a Unicode string where the revocation URL should be written.
pdwMaxChars
[in, out] Number of WCHAR characters that the buffer supplied by the client can hold; on return it contains the required number of characters.
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. |
| WMDM_E_BUFFERTOOSMALL | The buffer supplied by the client is too small. When the function returns, pdwMaxChars will contain the required number of characters. |
| E_FAIL | An unspecified error occurred. |
Remarks
The IMDSPRevoked interface retrieves the URL from which updated components can be downloaded if the service provider is ever revoked by any digital rights management system. If this method is not implemented, a default Microsoft URL will be used. This location is maintained by Microsoft and contains updates to components revoked by the Microsoft digital rights management system.
Requirements
Header: Defined in mswmdm.h.
Library: mssachlp.lib
See Also