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
S_OK
The method succeeded.
E_INVALIDARG
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

See also

IWMDRMMessageParser Interface