PsReplaceSiloContext, fonction (ntddk.h)

  • Article

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 retournée

Les codes de status NT suivants sont retournés.

Code de retour 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 .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1607
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête ntddk.h