AD RMS Callback Function Reference Callback Function

Many of the AD RMS 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.

Syntax

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

See Also

Callback Function
Active Directory Rights Management Services Reference
DRM_STATUS_MSG

Send comments about this topic to Microsoft

Build date: 3/13/2008