FsRtlOplockGetAnyBreakOwnerProcess, fonction (ntifs.h)

FsRtlOplockGetAnyBreakOwnerProcess retourne un propriétaire d’un verrou opportuniste (oplock) prétendument cassant.

Syntaxe

PEPROCESS FsRtlOplockGetAnyBreakOwnerProcess(
  POPLOCK Oplock
);

Paramètres

Oplock

Pointeur vers la structure oplock opaque pour le fichier. Ce pointeur doit avoir été initialisé par un appel précédent à FsRtlInitializeOplock.

Valeur retournée

Cette méthode retourne NULL si aucun propriétaire n’est trouvé ; sinon, il retourne un pointeur vers l’objet de processus d’un propriétaire (PEPROCESS).

Remarques

FsRtlOplockGetAnyBreakOwnerProcess sélectionne un propriétaire pour l’oplock prétendument cassant comme suit :

• Si l’oplock a un propriétaire exclusif, FsRtlOplockGetAnyBreakOwnerProcess retourne un pointeur vers l’EPROCESS du propriétaire exclusif.

• Si l’oplock n’a pas de propriétaire exclusif et que la file d’attente d’arrêt n’est pas vide, FsRtlOplockGetAnyBreakOwnerProcess retourne arbitrairement un pointeur vers le premier EPROCESS de la file d’attente.

• Sinon, FsRtlOplockGetAnyBreakOwnerProcess retourne NULL.

Si FsRtlOplockGetAnyBreakOwnerProcess retourne une valeur non NULL, l’appelant est chargé d’appeler ObDeferenceObject pour libérer la référence acquise en son nom.

FsRtlOplockGetAnyBreakOwnerProcess n’essaie pas de vérifier qu’un arrêt est réellement en attente ou que le processus qu’il retourne est bien le propriétaire.

Configuration requise

Voir aussi

FsRtlInitializeOplock

ObDeferenceObject