IWMDRMMessageParser::ParseRegistrationReqMsg method (wmsdkidl.h)
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
[ParseRegistrationReqMsg is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Microsoft PlayReady. ]
The ParseRegistrationReqMsg method extracts the device certificate and identifier from a registration message sent by a device.
Syntax
HRESULT ParseRegistrationReqMsg(
[in] BYTE *pbRegistrationReqMsg,
[in] DWORD cbRegistrationReqMsg,
[out] INSSBuffer **ppDeviceCert,
[out] DRM_VAL16 *pDeviceSerialNumber
);
Parameters
[in] pbRegistrationReqMsg
Address of the registration message in memory. This is a message received by your application from a device.
[in] cbRegistrationReqMsg
The size of registration message in bytes.
[out] ppDeviceCert
Address of a variable that receives the address of the INSSBuffer interface of the buffer object that contains the device certificate.
[out] pDeviceSerialNumber
Address of a DRM_VAL16 structure that receives the device identifier.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The pbRegistrationMsg parameter is NULL, or the cbRegistrationMsg parameter is 0. |
Remarks
Registration request messages are sent by devices when they are connected to a network shared by the computer running your application. When your application receives the message, it must first parse the message by using this method to retrieve the device certificate and device identifier. The combination of device certificate and device identifier uniquely identifies the device.
After parsing the message with this method, you can search the device database to determine whether the device is already registered, or you can try to register the device. Both of these actions use the methods of the IWMDeviceRegistration interface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only],Windows Media Format 9.5 SDK |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | wmsdkidl.h (include Wmsdk.h) |
| Library | WMStubDRM.lib |