Skip to content

Latest commit

 

History

History
86 lines (60 loc) · 2.92 KB

nf-wdm-ioremovelinkshareaccess.md

File metadata and controls

86 lines (60 loc) · 2.92 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames ms.custom f1_keywords topic_type api_type api_location api_name
NF:wdm.IoRemoveLinkShareAccess
IoRemoveLinkShareAccess function (wdm.h)
The IoRemoveLinkShareAccess routine removes the access and link share-access information for a given open instance of a file object.
kernel\ioremovelinkshareaccess.htm
kernel
04/30/2018
IoRemoveLinkShareAccess function
IoRemoveLinkShareAccess, IoRemoveLinkShareAccess function [Kernel-Mode Driver Architecture], kernel.ioremovelinkshareaccess, wdm/IoRemoveLinkShareAccess
wdm.h
Universal
Windows 10, version 1709
Windows Server 2016
NtosKrnl.lib
NtosKrnl.exe
PASSIVE_LEVEL
Windows
19H1
IoRemoveLinkShareAccess
wdm/IoRemoveLinkShareAccess
APIRef
kbSyntax
DllExport
NtosKrnl.exe
IoRemoveLinkShareAccess

IoRemoveLinkShareAccess function

-description

The IoRemoveLinkShareAccess routine removes the access and link share-access information for a given open instance of a file object.

-parameters

-param FileObject [in]

Pointer to the file object, which usually is being closed by the current thread.

-param ShareAccess [in, out]

A pointer to the common share-access data structure that is associated with FileObject. Drivers should treat this structure as opaque.

-param LinkShareAccess [in, out, optional]

A pointer to the common link share-access data structure (LINK_SHARE_ACCESS) that is associated with FileObject. Drivers should treat this structure as opaque.

-remarks

This routine is a reciprocal to IoUpdateLinkShareAccess.

IoRemoveLinkShareAccess is not an atomic operation. Therefore, drivers calling this routine must protect the shared file object passed to IoRemoveLinkShareAccess by means of some kind of lock, such as a mutex or a resource lock, in order to prevent corruption of the shared access counts.

Callers of IoRemoveLinkShareAccess must be running at IRQL = PASSIVE_LEVEL and in the context of the thread that requested that the FileObject be closed.

-see-also

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess