PsReplaceSiloContext, fonction (ntddk.h)

Article
02/07/2025

Cette routine insère un objet dans un Silo.

Syntaxe

NTSTATUS PsReplaceSiloContext(
  [in]       PESILO Silo,
  [in]       ULONG  ContextSlot,
  [in]       PVOID  NewSiloContext,
  [optional] PVOID  *OldSiloContext
);

Paramètres

[in] Silo

Pointeur vers un silo. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] ContextSlot

Emplacement alloué par la routine PsAllocSiloContextSlot.

[in] NewSiloContext

Pointeur vers l’objet créé par la routine PsCreateSiloContext. L’objet doit être créé à l’aide du même pointeur de silo que celui spécifié dans cette routine. Ce paramètre est obligatoire et ne peut pas être NULL.

[optional] OldSiloContext

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse de l’objet existant. Ce paramètre est facultatif et peut être NULL. L’adresse que le paramètre reçoit peut être NULL.

Valeur de retour

Les codes d’état NT suivants sont retournés.

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	Il n’existe aucune ressource dans le système pour effectuer l’insertion. Il s’agit d’un code d’erreur.
STATUS_NOT_SUPPORTED	L’emplacement est en lecture seule et il ne peut pas être modifié. Il s’agit d’un code d’erreur.
STATUS_SUCCESS	L’opération s’est terminée avec succès.

Remarques

Un appel réussi à PsReplaceSiloContext incrémente le nombre de références sur NewSiloContext. Si PsReplaceSiloContext échoue, le nombre de références reste inchangé. Dans les deux cas, l’appelant de PsReplaceSiloContext doit appeler PsDereferenceSiloContext pour décrémenter l’objet PsReplaceSiloContext. Si psReplaceSiloContext échoue et si le paramètre OldSiloContext n’est pas NULL et ne pointe pas vers NULL, NULL est un pointeur référencé. Une fois la routine terminée, l’appelant doit appeler PsDereferenceSiloContext pour décrémenter l’objet vers lequel pointe le paramètre NULL.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1607
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
d’en-tête	ntddk.h

Partager via