DRM_MSG_ACQUIRE_ISSUANCE_LICENSE_TEMPLATE message

[The AD RMS SDK leveraging functionality exposed by the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1, which leverages functionality exposed by the client in Msipc.dll.]

The DRM_MSG_ACQUIRE_ISSUANCE_LICENSE_TEMPLATE message is sent to the custom callback function when you call the DRMAcquireIssuanceLicenseTemplate function.

Parameters

hr

The result of the action being monitored. This can be one of the following values, which are defined in msdrmerror.h.

S_DRM_COMPLETED ()

The operation is complete. The template collection is saved in the local template store.

E_DRM_ABORTED ()

Template acquisition was canceled.

E_DRM_NO_CONNECT ()

The server was not available.

E_DRM_SERVER_NOT_FOUND ()

The attempt to contact the server returned HTTP 404, indicating that the template distribution service was not found.

E_DRM_TEMPLATE_ACQUISITION_FAILED ()

The template collection could not be retrieved from the server. This can occur for a variety of reasons such as an HTTP 401 (authentication) error.

pvParam

This parameter is always NULL.

pvContext

An application-defined value, such as a pointer to a callback function, a pointer to an event handle, or other value.

Return value

If the callback function succeeds, the function returns S_OK.

If the callback function fails, it returns an HRESULT error code.

Remarks

The DRMAcquireIssuanceLicenseTemplate function is an asynchronous function that will return before this message is sent to the callback function. It is the application's responsibility to ensure that this synchronization is properly handled.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Msdrmdefs.h

See also

Creating a Callback Function
DRM_STATUS_MSG
DRMAcquireIssuanceLicenseTemplate

 

 

Show: