nf-ntddk-psinsertpermanentsilocontext.md

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	f1_keywords	topic_type	api_type	api_location	api_name
NF:ntddk.PsInsertPermanentSiloContext	PsInsertPermanentSiloContext function (ntddk.h)	This routine inserts an object in an empty slot in a Silo.	kernel\psinsertpermanentsilocontext.htm	kernel	04/30/2018	PsInsertPermanentSiloContext function	PsInsertPermanentSiloContext, PsInsertPermanentSiloContext routine [Kernel-Mode Driver Architecture], kernel.psinsertpermanentsilocontext, ntddk/PsInsertPermanentSiloContext	ntddk.h		Windows	Windows 10, version 1607	Windows Server 2016													Windows		PsInsertPermanentSiloContext ntddk/PsInsertPermanentSiloContext	APIRef kbSyntax	HeaderDef	ntddk.h	PsInsertPermanentSiloContext

PsInsertPermanentSiloContext function

-description

This routine inserts an object in an empty slot in a Silo.

-parameters

-param Silo [in]

The silo in which the object is to be inserted. This parameter is required and it cannot be NULL.

-param ContextSlot [in]

The slot in which the object is to be inserted. A slot allocated by the PsAllocSiloContextSlot routine.

-param SiloContext [in]

The object to be inserted, created by the PsCreateSiloContext routine. The object must be created using the same silo as specified in the Silo parameter. This parameter is required and it cannot be NULL.

-returns

The following NT status codes are returned.

Return code	Description
STATUS_INSUFFICIENT_RESOURCES	There are no resources in the system to perform the insert. This is an error code.
STATUS_NOT_SUPPORTED	The slot is not empty. This is an error code.
STATUS_SUCCESS	The operation completed successfully.

-remarks

A successful call to PsInsertPermanentSiloContext increments the reference count on SiloContext. If PsInsertPermanentSiloContext fails, the reference count remains unchanged. In either case, after the routine completes, the caller must call PsDereferenceSiloContext to decrement the SiloContext object.