ZwOpenSymbolicLinkObject routine

ZwOpenSymbolicLinkObject 例程打开一个已经存在的符号链接。

Syntax

 

NTSTATUS ZwOpenSymbolicLinkObject(  _Out_ PHANDLE            LinkHandle,  _In_  ACCESS_MASK        DesiredAccess,  _In_  POBJECT_ATTRIBUTES ObjectAttributes);

 

Parameters

LinkHandle [out]

指向一个HANDLE变量的参数，用它来接收一个符号链接对象的句柄。

DesiredAccess [in]

指定希望在对象上执行操作的访问权限，调用者通常指定GENERIC_READ, 那样句柄就可以被传递给ZwQuerySymbolicLinkObject.

ObjectAttributes [in]

指向一个OBJECT_ATTRIBUTES 结构体的指针，该结构体指定对象名称和对象其他的属性。使用 InitializeObjectAttributes 初始化这个结构。如果调用者没有在一个系统线程的上下文中运行，那么当调用InitializeObjectAttributes 的时候必须指定OBJ_KERNEL_HANDLE 属性。

Return value

ZwOpenSymbolicLinkObject 成功时返回 STATUS_SUCCESS ，或者是一个合适的错误码。

Remarks

当打开的符号链接句柄不再使用时候，驱动程序必须调用ZwClose 关闭它。

如果调用者并没有在一个系统线程的上下文中运行，必须保证任何它创建的句柄都是私有的句柄，否则句柄可以被其他在驱动上运行的进程上下文访问。更多信息见： Object Handles.

Note  如果在用户控件调用，使用 "NtOpenSymbolicLinkObject"名字代替 "ZwOpenSymbolicLinkObject".

 

Requirements

Target platform

Universal

Version

Available in Windows 2000 and later versions of Windows.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

PASSIVE_LEVEL

DDI compliance rules

PowerIrpDDis, HwStorPortProhibitedDDIs

See also

ACCESS_MASK

InitializeObjectAttributes

ZwQuerySymbolicLinkObject