#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 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. 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.