FsRtlOplockGetAnyBreakOwnerProcess, fonction (ntifs.h)
FsRtlOplockGetAnyBreakOwnerProcess retourne un propriétaire d’un verrou opportuniste prétendument cassant (oplock).
Syntaxe
PEPROCESS FsRtlOplockGetAnyBreakOwnerProcess(
POPLOCK Oplock
);
Paramètres
Oplock
Pointeur vers la structure oplock opaque du fichier. Ce pointeur doit avoir été initialisé par un appel précédent à FsRtlInitializeOplock.
Valeur de retour
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 le processus 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 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 en effet le propriétaire.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 2004 |
| d’en-tête | ntifs.h |