Función PsReplaceSiloContext (ntddk.h)

  • Artículo

Esta rutina inserta un objeto en un Silo.

Sintaxis

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

Parámetros

[in] Silo

Puntero a un silo.  Este parámetro es necesario y no puede ser NULL.

[in] ContextSlot

Ranura asignada por la rutina PsAllocSiloContextSlot .

[in] NewSiloContext

Puntero al objeto creado por la rutina PsCreateSiloContext . El objeto debe crearse con el mismo puntero de silo que el especificado en esta rutina. Este parámetro es necesario y no puede ser NULL.

[optional] OldSiloContext

Puntero a una variable asignada por el autor de la llamada que recibe la dirección del objeto existente. Este parámetro es opcional y puede ser NULL. La dirección que recibe el parámetro puede ser NULL.

Valor devuelto

Se devuelven los siguientes códigos de estado NT.

Código devuelto Descripción
STATUS_INSUFFICIENT_RESOURCES
No hay recursos en el sistema para realizar la inserción. Se trata de un código de error. 
STATUS_NOT_SUPPORTED
 La ranura es de solo lectura y no se puede modificar. Se trata de un código de error.
STATUS_SUCCESS
 La operación se ha completado correctamente.

Comentarios

Una llamada correcta a PsReplaceSiloContext incrementa el recuento de referencias en NewSiloContext. Si se produce un error en PsReplaceSiloContext , el recuento de referencias permanece sin cambios. En cualquier caso, el autor de la llamada de PsReplaceSiloContext debe llamar a PsDereferenceSiloContext para disminuir el objeto PsReplaceSiloContext . Si Se produce un error en PsReplaceSiloContext y si el parámetro OldSiloContext no es NULL y no apunta a NULL , NULL es un puntero al que se hace referencia. Una vez completada la rutina, el autor de la llamada debe llamar a PsDereferenceSiloContext para disminuir el objeto al que apunta el parámetro NULL .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado ntddk.h