INetCfgLock

The INetCfgLock interface provides methods that are used to obtain a lock on network configuration so a client can safely configure network components and binding paths.

The interface identifier (IID) for this interface is IID_INetCfgLock.

When to Implement

It is not necessary to implement the methods of this interface. They are implemented in Netcfgx.dll.

When to Use

Use this interface to obtain an operating system-wide lock on network configuration.

Methods

The following methods are listed in Vtable order:

IUnknown method	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.

 

INetCfgLock method	Description
AcquireWriteLock	Requests a lock on network configuration for a particular client.
ReleaseWriteLock	Releases a previously obtained lock on network configuration.
IsWriteLocked	Indicates the name of the client that currently controls network configuration.

 

Comments

There can only be one write lock per operating system.

Applications call the QueryInterface method of the INetCfginterface to obtain a pointer to INetCfgLock.

See Also

INetCfg

Requirements

Header

Netcfgx.h (include Netcfgx.h)

 

 

Send comments about this topic to Microsoft