CcGetFileObjectFromSectionPtrsRef function (ntifs.h)

Article
02/22/2024

When passed a pointer to a SECTION_OBJECT_POINTERS structure for a cached file, the CcGetFileObjectFromSectionPtrsRef routine returns a pointer to the file object that the cache manager is using for the cached file.

Syntax

PFILE_OBJECT CcGetFileObjectFromSectionPtrsRef(
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer
);

Parameters

[in] SectionObjectPointer

A pointer to the SECTION_OBJECT_POINTERS structure that is associated with the cached file.

Return value

A pointer to the file object for the cached file, or NULL if the file is not cached or is no longer cached.

Remarks

The file object is returned with a reference. The caller is responsible for calling ObDereferenceObject on the file object when it has finished using the file object.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Target Platform	Universal
Header	ntifs.h (include Ntifs.h, Fltkernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe