ILMDSKernel2::UnlockModule


Note

As of v21 the LEADTOOLS Multimedia toolkit has been updated to use a seamless license mechanism and any new development must use it. The new licensing mechanism uses L_SetLicenseFile and L_SetLicenseBuffer. For a step-by-step tutorial on a C DLL platform, refer to Add References and Set a License.

The ILMDSKernel2::UnlockModule mechanism is still supported in v21.


#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

If Flags contains UNLOCK_APP_ONCE or UNLOCK_COMPUTER: The application ID; a unique ID of the calling application. The caller is responsible for uniqueness of this ID. It is recommended to use the full path of the application.

If Flags contains UNLOCK_APP_PATH: The application full path of the application (the long version, not the short 8.3 version of the path).

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 ShowDirectShow documentation.

Comments

Use this function to change the state for the modules that are unlocked to Release. Please note the following:

Required DLLs and Libraries

DSKernel2.dll

See Also

Elements:

ILMDSKernel2::LockModules

Example

For an example, refer to Using the DSKernel Object.

Help Version 21.0.2021.7.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Filters C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.