Functia NtCreateResourceManager (wdm.h) – drivere Windows

• 30.04.2018
• 3 minute de citit

In acest articol

ZwCreateResourceManager Rutina creeaza un obiect manager de resurse.

Sintaxa

__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateResourceManager (PHANDLE ResourceManagerHandle, ACCESS_MASK DesiredAccess, HANDLE TmHandle, LPGUID RmGuid, POBJECT_ATTRIBUTES ObjectAttributes, ULONG CreateOptions;

Parametrii

ResourceManagerHandle

[out] Un indicator catre o variabila alocata apelantului care primeste un handle catre noul obiect manager de resurse daca apelul catre ZwCreateResourceManager are succes.

Acces dorit

[in] O valoare ACCESS_MASK care specifica accesul solicitat de apelant la obiectul manager de resurse. In plus fata de drepturile de acces definite pentru toate tipurile de obiecte (vezi ACCESS_MASK ), apelantul poate specifica oricare dintre urmatoarele steaguri de drepturi de acces pentru obiectele managerului de resurse:

Flag ACCESS_MASK Permite apelantului sa se inregistreze RESOURCEMANAGER_ENLIST in tranzactii (consultati ZwCreateEnlistment). RESOURCEMANAGER_GET_NOTIFICATION Primiti notificari despre tranzactiile asociate cu acest manager de resurse (consultati ZwGetNotificationResourceManager). RESOURCEMANAGER_REGISTER_PROTOCOL Neutilizat. RESOURCEMANAGER_QUERY_INFORMATION Solicitati informatii despre managerul de resurse (consultati ZwQueryInformationResourceManager). RESOURCEMANAGER_SET_INFORMATION Nu este utilizat. RESOURCEMANAGER_RECOVER Recuperati managerul de resurse (consultati ZwRecoverResourceManager). RESOURCEMANAGER_COMPLETE_PROPAGATION Nu este utilizat.  

Alternativ, puteti specifica unul sau mai multe dintre urmatoarele indicatoare generice ACCESS_MASK. ( Semnalizatoarele STANDARD_RIGHTS_ Xxx sunt valori de sistem predefinite care sunt utilizate pentru a impune securitatea obiectelor de sistem.) De asemenea, puteti combina aceste semnalizatoare generice cu semnalizari suplimentare din tabelul precedent. Tabelul urmator arata modul in care drepturile de acces generice corespund unor drepturi de acces specifice.

acces generic drept set de drepturi de acces specifice RESOURCEMANAGER_GENERIC_READ STANDARD_RIGHTS_READ, RESOURCEMANAGER_QUERY_INFORMATION, si sa sincronizeze RESOURCEMANAGER_GENERIC_WRITE STANDARD_RIGHTS_WRITE, RESOURCEMANAGER_SET_INFORMATION, RESOURCEMANAGER_RECOVER, RESOURCEMANAGER_ENLIST, RESOURCEMANAGER_GET_NOTIFICATION, RESOURCEMANAGER_REGISTER_PROTOCOL, RESOURCEMANAGER_COMPLETE_PROPAGATION, si sa sincronizeze RESOURCEMANAGER_GENERIC_EXECUTE STANDARD_RIGHTS_EXECUTE, RESOURCEMANAGER_RECOVER, RESOURCEMANAGER_ENLIST, RESOURCEMANAGER_GET_NOTIFICATION, RESOURCEMANAGER_COMPLETE_PROPAGATION, si sa sincronizeze RESOURCEMANAGER_ALL_ACCESS STANDARD_RIGHTS_REQUIRED, RESOURCEMANAGER_GENERIC_READ, RESOURCEMANAGER_GENERIC_WRITE si RESOURCEMANAGER_GENERIC_EXECUTE

TmHandle

[in] Un handle pentru un obiect manager de tranzactii care a fost obtinut de un precedent all catre ZwCreateTransactionManager sau ZwOpenTransactionManager.

RmGuid

[in] Un indicator catre un GUID pe care KTM il va utiliza pentru a identifica managerul de resurse. Daca acest indicator este NULL , KTM genereaza un GUID.

ObjectAttributes

[in, optional] Un indicator catre o structura OBJECT_ATTRIBUTES care specifica numele obiectului si alte atribute. Utilizati rutina InitializeObjectAttributes pentru a initializa aceasta structura. Daca apelantul nu ruleaza intr-un context de fir de sistem, trebuie sa seteze atributul OBJ_KERNEL_HANDLE atunci cand apeleaza InitializeObjectAttributes . Acest parametru este optional si poate fi NUL .

CreateOptions

[in, optional] Steaguri optionale de creare a obiectelor. Urmatorul tabel contine semnalizatoarele disponibile, care sunt definite in Ktmtypes.h.

CreateOptions flag Semnificatie RESOURCE_MANAGER_COMMUNICATION Numai pentru uz intern. RESOURCE_MANAGER_VOLATILE Apelantul va gestiona resurse volatile. Acesta va fi non-persistent si nu va efectua recuperarea.  

Acest parametru este optional si poate fi zero.

Descriere

[in, optional] Un indicator catre o structura UNICODE_STRING furnizata de apelant care contine un sir terminat NULL. Sirul ofera o descriere a managerului de resurse. KTM stocheaza o copie a sirului si include sirul in mesajele pe care le scrie in fluxul de jurnal. Lungimea maxima a sirului este MAX_RESOURCEMANAGER_DESCRIPTION_LENGTH. Acest parametru este optional si poate fi NUL .

Valoare returnata

ZwCreateResourceManager returneaza STATUS_SUCCESS daca operatiunea reuseste. In caz contrar, aceasta rutina ar putea returna una dintre urmatoarele valori:

Cod de returnare Descriere

STATUS_OBJECT_TYPE_MISMATCH

Handle- ul specificat de TmHandle nu este un handle pentru un obiect de tranzactie.

STATUS_INVALID_HANDLE

Manerul specificat de TmHandle nu este valid.

STATUS_ACCESS_DENIED

Apelantul nu are acces adecvat la obiectul manager de tranzactii specificat.

STATUS_TRANSACTION_OBJECT_EXPIRED

Manerul specificat de TmHandle este inchis.

STATUS_INVALID_PARAMETER

Valoarea parametrului CreateOptions este nevalida sau sirul parametrului Descriere este prea lung.

STATUS_TM_VOLATILE

CreateOptions Parametrul nu specifica RESOURCE_MANAGER_VOLATILE , dar managerul de tranzactie care TmHandle specifica este volatil.

STATUS_OBJECT_NAME_COLLISION

GUID-ul specificat de ResourceManagerGuid exista deja.

STATUS_ACCESS_DENIED

Valoarea parametrului DesiredAccess nu este valida.  

Rutina ar putea returna alte valori NTSTATUS.

Un manager de resurse care apeleaza ZwCreateResourceManager trebuie sa apeleze in cele din urma ZwClose pentru a inchide manerul obiectului.

Pentru mai multe informatii despre ZwCreateResourceManager , consultati Crearea unui manager de resurse.

Pentru apelurile de la driverele in modul kernel, versiunile Nt Xxx si Zw Xxx ale unei rutine Windows Native System Services se pot comporta diferit in modul in care gestioneaza si interpreteaza parametrii de intrare. Pentru mai multe informatii despre relatia dintre versiunile Nt Xxx si Zw Xxx ale unei rutine, consultati Utilizarea versiunilor Nt si Zw ale rutinelor Native System Services.

Cerinte

    Client minim acceptat Disponibil in Windows Vista si versiunile ulterioare ale sistemului de operare. Platforma tinta universala Antet wdm.h (includ Wdm.h, Ntddk.h, Ntifs.h) Biblioteca NtosKrnl.lib DLL Ntoskrnl.exe ICCV PASSIVE_LEVEL DDI Regulile privind conformitatea PowerIrpDDis, HwStorPortProhibitedDDIs

Vezi si

ACCESS_MASK

InitializeObjectAttributes

OBJECT_ATTRIBUTES

UNICODE_STRING

ZwClose

ZwCreateEnlistment

ZwCreateTransactionManager

ZwGetNotificationResourceManager

ZwOpenResourceManager

ZwOpenTransactionManager

ZwQueryInformationResourceManager

ZwRecoverResourceManager