DuplicateHandle

DuplicateHandle

VB声明

Declare Function DuplicateHandle Lib "kernel32" Alias "DuplicateHandle" (ByVal hSourceProcessHandle As Long, ByVal hSourceHandle As Long, ByVal hTargetProcessHandle As Long, lpTargetHandle As Long, ByVal dwDesiredAccess As Long, ByVal bInheritHandle As Long, ByVal dwOptions As Long) As Long

说明

在指出一个现有系统对象当前句柄的情况下,为那个对象创建一个新句柄。当前句柄可能位于一个不同的进程

返回值

Long,非零表示成功,零表示失败。会设置GetLastError

参数表

参数

类型及说明

hSourceProcessHandle

Long,拥有源句柄的那个进程的句柄。如源句柄从属于当前进程,则使用GetCurrentProcess

hSourceHandle

Long,指定对象的现有句柄。

hTargetProcessHandle

Long,即将拥有新对象句柄的一个进程的句柄。如源句柄从属于当前进程,则使用GetCurrentProcess

lpTargetHandle

Long,指定用于装载新句柄的一个长整型变量

dwDesiredAccess

Long,新句柄要求的安全访问级别。如dwOptions已指定了DUPLICATE_SAME_ACCESS,那么忽略这里的设置。可以进行的访问由对象的类型决定,它们在不同系统对象的访问常数表里进行了总结

bInheritHandle

Long,如新句柄可由hSourceProcessHandle的子进程继承,则为TRUE

dwOptions

Long,下列常数的一个或两个:

DUPLICATE_SAME_ACCESS

新句柄拥有与原始句柄相同的安全访问特征

DUPLICATE_CLOSE_SOURCE

原始句柄已经关闭。即使发生错误。它也要关闭

注解

在一个进程中,这个函数可根据位于不同进程内的现有句柄创建一个新句柄。可以从这两个进程中发出对这个函数的调用。进程必须提供PROCESS_DUP_HANDLE访问权限,否则函数执行不能成功

句柄可以重复的对象包括控制台、文件(包括通信设备)、文件映射、事件、可等待计时器、互斥体、管道、进程、注册表项、信号机以及线程

Top