ILMDSKernel2::UnlockModule
#include "ILMDSKernel2.h"
C Syntax |
HRESULT ILMDSKernel2_UnlockModule(pDSKrn, Key, Flags, AppID) |
C++ Syntax |
HRESULT UnlockModule(BSTR Key, long Flags, BSTR AppID) |
VB Syntax |
object.UnlockModule(Key As String, Flags As Long, AppID As String) As Long |
ILMDSKernel2 *pDSKrn; |
/* pointer to an interface */ |
BSTR Key; |
/* serial number */ |
long Flags; |
/* flags */ |
BSTR AppID; |
/* calling application ID */ |
Unlocks a specific module, or group of modules (depending on the serial number, or Key).
Parameter |
Description |
pDSKrn |
Pointer to an ILMDSKernel2 interface. |
Key |
A string that represents the module serial number. This parameter cannot be NULL (empty). |
Flags |
One of the UnLockFlagsConstants2 enumeration values that specify the level at which the unlocking operation will be performed. |
AppID |
The application ID; a unique ID of the calling application. The caller is responsible for uniqueness of this ID. It is recommended to use a globally unique ID (GUID). This parameter cannot be NULL (empty). |
Returns
S_OK |
The function ran successfully. |
<> S_OK |
An error occurred. Refer to theError Codes or the HRESULT error codes in the DirectShow documentation. |
Comments
Use this function to change the state for the modules that are unlocked to Release. Please note the following:
The Key is a unique module serial number that must be purchased from LEAD.
It may be necessary to call the function several times to unlock several toolkits (or functionalities).
Each module has its own key, but some keys can unlock more than one filter/module.
The AppID is used to uniquely identify the calling application.
Required DLLs and Libraries
DSKernel2.dll |
See Also
Elements: |
Example
For an example, refer to Using the DSKernel Object.