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