Callback Function
The callback function acts both as a way for the application to retrieve requested licenses and certificates returned by asynchronous function calls, and as a way to notify an application of the progress of asynchronous function calls. The only requested items directly returned through the callback function are a signed issuance license, requested by using the DRMGetSignedIssuanceLicense function, and a rights account certificate, requested by using the DRMActivate function. All other items (such as machine certificates and revocation lists) must be retrieved from the license store by using the DRMEnumerateLicense function.
A callback function pointer is passed directly into the following functions:
The callback function pointer is indirectly passed into the following functions through the session handle parameter. The following functions allow arbitrary data to be passed through their pvContext parameter to the pvContext parameter of the callback function:
The pvContext parameter can contain any 32-bit value such as an event handle that can be used to signal that an asynchronous function has completed. Alternatively, it could contain any other data or object that you want. The responsibility for handling this object belongs to the callback function.
The prototype of the callback function is defined in the AD RMS Callback Function Reference section.
Many of the samples included with the AD RMS SDK show how to create a callback function. The function is named StatusCallback in all samples. For more information, see Client Sample Programs.
See Also
Methods Used by All Client Applications
AD RMS Callback Function Reference
Send comments about this topic to Microsoft
Build date: 3/13/2008