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 or path */ |
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 |
This parameter cannot be NULL (empty). |
Returns
S_OK |
The function ran successfully. |
<> S_OK |
An error occurred. Refer to the Error 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 filters/codecs).
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. The AppID must be set to the application path if you unlock using UNLOCK_APP_PATH.
The UNLOCK_APP_ALWAYS has been deprecated. Currently, it has the same effect as UNLOCK_APP_ONCE and support for it might be dropped in the future. You should use UNLOCK_APP_PATH if you want to unlock a particular app.
Required DLLs and Libraries
DSKernel2.dll |
See Also
Elements: |
Example
For an example, refer to Using the DSKernel Object.