DRM_MSG_ACTIVATE_GROUPIDENTITY 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_ACTIVATE_GROUPIDENTITY message is sent to the custom callback function in response to the DRMActivate function being called with the DRM_ACTIVATE_GROUPIDENTITY option.
Parameters
-
hr
-
The result of the action being monitored. The pvParam parameter is dependent on the value of hr. This can be one of the following values.
-
E_DRM_ABORTED (NULL)
-
The activation attempt was ended.
-
E_DRM_ACTIVATIONFAILED (NULL)
-
The activation attempt failed.
-
E_DRM_AD_ENTRY_NOT_FOUND (NULL)
-
The user could not be found in Active Directory.
-
E_DRM_AUTHENTICATION_FAILED (NULL)
-
The user could not be authenticated.
-
S_DRM_COMPLETED (A pointer to a null-terminated Unicode string that contains the retrieved rights account certificate. The certificate is also entered in the license store, where it can be retrieved by using the DRMEnumerateLicense function. The memory will be deallocated immediately after returning from the callback function, so you must copy the string within the callback if you want to keep it.)
-
This is the last value a successful activation attempt should send.
-
S_DRM_CONNECTED (NULL)
-
The system has connected to a server.
-
S_DRM_CONNECTING (NULL)
-
A connection has not yet occurred.
-
E_DRM_EMAIL_NOT_VERIFIED (NULL)
-
The supplied email address cannot be verified.
-
S_DRM_INPROGRESS (A pointer to a DWORD that contains an integer that represents the progress of the current request, from zero to 100.)
-
This can be used for a progress bar or other visual indicator.
-
E_DRM_INVALID_EMAIL (NULL)
-
The supplied email address is not valid.
-
E_DRM_INVALID_SERVER_RESPONSE (NULL)
-
The response from the server is not valid.
-
E_DRM_NEEDS_MACHINE_ACTIVATION (NULL)
-
The computer must be activated before the user can be activated.
-
E_DRM_NO_CONNECT (NULL)
-
Cannot connect to the Active Directory Rights Management Services (AD RMS) server.
-
E_DRM_REQUEST_DENIED (NULL)
-
The request to activate the user was denied.
-
E_DRM_SERVER_ERROR (NULL)
-
A general server error occurred.
-
E_DRM_SERVER_NOT_FOUND (NULL)
-
The AD RMS server was not found.
-
E_DRM_SERVICE_GONE (NULL)
-
The activation service was not found.
-
E_DRM_SERVICE_MOVED (NULL)
-
The activation service has moved to another server.
-
E_DRM_VALIDITYTIME_VIOLATION (NULL)
-
The certificate validity has expired.
pvParam
The contents of this parameter is dependent on the value in the hr parameter. For more information, see the hr parameter description.
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 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.
Remarks
The DRMActivate 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
| Product |
Rights Management Services client 1.0 SP2 or later |
| Header |
|