Export (0) Print
Expand All

NtQueryDirectoryObject function

[This function may be altered or unavailable in the future.]

Retrieves information about the specified directory object.

Syntax


NTSTATUS WINAPI NtQueryDirectoryObject(
  _In_       HANDLE DirectoryHandle,
  _Out_opt_  PVOID Buffer,
  _In_       ULONG Length,
  _In_       BOOLEAN ReturnSingleEntry,
  _In_       BOOLEAN RestartScan,
  _Inout_    PULONG Context,
  _Out_opt_  PULONG ReturnLength
);

Parameters

DirectoryHandle [in]

A handle to the directory object.

Buffer [out, optional]

A pointer to a buffer that receives the directory information. This buffer receives one or more OBJECT_DIRECTORY_INFORMATION structures, the last one being NULL, followed by strings that contain the names of the directory entries. For more information, see Remarks.

Length [in]

The size of the user-supplied output buffer, in bytes.

ReturnSingleEntry [in]

Indicates whether the function should return only a single entry.

RestartScan [in]

Indicates whether to restart the scan or continue the enumeration using the information passed in the Context parameter.

Context [in, out]

The enumeration context.

ReturnLength [out, optional]

A pointer to a variable that receives the length of the directory information returned in the output buffer, in bytes.

Return value

The function returns STATUS_SUCCESS or an error status.

Remarks

The following is the definition of the OBJECT_DIRECTORY_INFORMATION structure.

typedef struct _OBJECT_DIRECTORY_INFORMATION {
    UNICODE_STRING Name;
    UNICODE_STRING TypeName;
} OBJECT_DIRECTORY_INFORMATION, *POBJECT_DIRECTORY_INFORMATION;

This function has no associated import library or header file; you must call it using the LoadLibrary and GetProcAddress functions.

Requirements

DLL

Ntdll.dll

See also

NtOpenDirectoryObject

 

 

Community Additions

ADD
Show:
© 2014 Microsoft