Funzione NtSetInformationEnlistment (wdm.h)

Articolo
02/27/2024

La routine ZwSetInformationEnlistment imposta informazioni per un oggetto di inserimento specificato.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

Parametri

[in] EnlistmentHandle

Handle a un oggetto enlistment ottenuto da una chiamata precedente a ZwCreateEnlistment o ZwOpenEnlistment. L'handle deve avere ENLISTMENT_SET_INFORMATION accesso all'oggetto.

[in] EnlistmentInformationClass

Valore di enumerazione ENLISTMENT_INFORMATION_CLASS tipizzato che specifica il tipo di informazioni da impostare. Questo valore deve essere EnlistmentRecoveryInformation.

I valori EnlistmentBasicInformation e EnlistmentFullInformation dell'enumerazione non vengono usati con ZwSetInformationEnlistment.

[in] EnlistmentInformation

Puntatore a un buffer allocato dal chiamante che contiene informazioni di ripristino definite dal chiamante per l'inserimento.

[in] EnlistmentInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro EnlistmentInformation .

Valore restituito

ZwSetInformationEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto enlistment.
STATUS_INVALID_HANDLE	L'handle dell'oggetto non è valido.
STATUS_INVALID_INFO_CLASS	Il valore del parametro EnlistmentInformationClass non è valido.
STATUS_INFO_LENGTH_MISMATCH	Il valore del parametro EnlistmentInformationLength non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto enlistment.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Un gestore risorse può usare la routine ZwSetInformationEnlistment per impostare le informazioni di ripristino per un elenco. KTM scrive le informazioni di ripristino nel flusso di log e il gestore risorse può chiamare ZwQueryInformationEnlistment per leggere queste informazioni dal flusso di log in qualsiasi momento.

Ogni chiamata successiva a ZwSetInformationEnlistment elimina le informazioni di ripristino specificate prima di archiviare le nuove informazioni di ripristino.

Per altre informazioni sull'uso di ZwSetInformationEnlistment, vedere Uso di flussi di log con KTM.

NtSetInformationEnlistment e ZwSetInformationEnlistment sono due versioni della stessa routine di Windows Native System Services.

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Vedi anche

ENLISTMENT_INFORMATION_CLASS

Uso di nt e zw versioni delle routine di Servizi di sistema nativo

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment

Condividi tramite