LEADTOOLS Filters Help
| LEADTOOLS Filters Help > Multimedia Filter and Codec Licensing > LEAD Multimedia Evaluation Mechanism > ILMDSKernel2::LockModules |
When "getting" a BSTR property, the memory containing the string is allocated with SysAllocString. When this string is no longer needed, free this memory by calling SysFreeString if you are working in an environment such as C or C++ that does not automatically delete the memory. VB automatically deletes the memory, so VB programmers do not need to free the memory themselves.
#include "ILMDSKernel2.h"
|
C Syntax |
HRESULT ILMDSKernel2_LockModules(pDSKrn, AppID, Flags) |
|
C++ Syntax |
HRESULT LockModules(AppID, Flags) |
|
VB Syntax |
object.LockModules(AppID As String, Flags As Long) As Long |
|
ILMDSKernel2 *pDSKrn; |
/* pointer to an interface */ |
|
BSTR AppID; |
/* application ID that is doing the calling */ |
|
long Flags; |
/* flags */ |
Locks all modules of the same AppID that were unlocked using ILMDSKernel2::UnlockModule.
|
Parameter |
Description |
|
pDSKrn |
Pointer to an ILMDSKernel2 interface. |
|
AppID |
The application ID. This cannot be NULL (empty). |
|
Flags |
Flags that specify the level at which locking will be performed. For a list of possible values, refer to LockFlagsConstants2. |
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
You must call ILMDSKernel2::LockModules:
When the application terminates, if unlocking was performed at the application level using UNLOCK_APP_ONCE.
When uninstalling the application, if unlocking was performed at the computer level using UNLOCK_COMPUTER or UNLOCK_APP_PATH.
Required DLLs and Libraries
|
DSKernel2.dll |
See Also
|
Elements: |
Example
For an example, refer to Using the DSKernel Object.
