ADRMS Callback Function Reference
Many of the ADRMS APIs provide status and feedback information by using a callback function. This callback function is implemented by the application that is calling the API. The prototype of the callback function is shown here.
HRESULT __stdcall myCallbackFunctionName(
DRM_STATUS_MSG msg,
HRESULT hr,
VOID* pvParam,
VOID* pvContext
);
Parameters
- msg
Specifies what action is being performed. This can be one of the DRM_STATUS_MSG enumeration values. - hr
The status of the current action. - pvParam
The contents of this parameter depends on the action and status being processed. For more information, see the specific message value in the DRM_STATUS_MSG enumeration. - pvContext
An application-defined value, such as a pointer to a callback function, a pointer to an event handle, or another value.
Return Value
If the function succeeds, the function returns S_OK.
If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.
Requirements
| Product | Requires Rights Management Services client 1.0 or later. |
| Header | Declared in Msdrmdefs.h. |
See Also
Callback Function
Active Directory Rights Management Services Reference
DRM_STATUS_MSG