nf-processsnapshot-pssduplicatesnapshot.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	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	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:processsnapshot.PssDuplicateSnapshot	PssDuplicateSnapshot function (processsnapshot.h)	Duplicates a snapshot handle from one process to another.	PssDuplicateSnapshot PssDuplicateSnapshot function proc_snap.pssduplicatesnapshot processsnapshot/PssDuplicateSnapshot	proc_snap\pssduplicatesnapshot.htm	proc_snap	5D2751F3-E7E1-4917-8060-E2BC8A7A3DEA	12/05/2018	PssDuplicateSnapshot, PssDuplicateSnapshot function, proc_snap.pssduplicatesnapshot, processsnapshot/PssDuplicateSnapshot	processsnapshot.h		Windows	Windows 8.1 [desktop apps only]	Windows Server 2012 R2 [desktop apps only]											Kernel32.dll		Windows			19H1	PssDuplicateSnapshot processsnapshot/PssDuplicateSnapshot	c++	APIRef kbSyntax	DllExport	kernel32.dll API-MS-Win-Core-Processsnapshot-l1-1-0.dll KernelBase.dll	PssDuplicateSnapshot

PssDuplicateSnapshot function

-description

Duplicates a snapshot handle from one process to another.

-parameters

-param SourceProcessHandle [in]

A handle to the source process from which the original snapshot was captured. The handle must have PROCESS_VM_READ and PROCESS_DUP_HANDLE rights.

-param SnapshotHandle [in]

A handle to the snapshot to duplicate. This handle must be in the context of the source process.

-param TargetProcessHandle [in]

A handle to the target process that receives the duplicate snapshot. The handle must have PROCESS_VM_OPERATION, PROCESS_VM_WRITE, and PROCESS_DUP_HANDLE rights.

-param TargetSnapshotHandle [out]

A handle to the duplicate snapshot that this function creates, in the context of the target process.

-param Flags [in, optional]

The duplication flags. For more information, see PSS_DUPLICATE_FLAGS.

-returns

This function returns ERROR_SUCCESS on success or the following error code.

Return code	Description
ERROR_INVALID_HANDLE	The specified handle is invalid.

 

All error codes are defined in winerror.h. Use FormatMessage with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a message for an error code.

-see-also

Process Snapshotting