共用方式為

NtQueryDirectoryObject 函式

  • 發行項

[未來可能會變更或無法使用此函式。]

擷取指定之目錄物件的相關資訊。

語法

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
);

參數

DirectoryHandle [in]

目錄物件的控制碼。

緩衝區 [out， 選擇性]

接收目錄資訊的緩衝區指標。 這個緩衝區會收到一或多個 OBJECT_DIRECTORY_INFORMATION 結構，最後一個是 Null，後面接著包含目錄專案名稱的字串。 如需詳細資訊，請參閱＜備註＞。

長度 [in]

使用者提供的輸出緩衝區大小，以位元組為單位。

ReturnSingleEntry [in]

指出函式是否應該只傳回單一專案。

RestartScan [in]

指出是否要重新開機掃描，或使用 CoNtext 參數中傳遞的資訊繼續列舉。

內容 [in， out]

列舉內容。

ReturnLength [out， optional]

變數的指標，接收輸出緩衝區中傳回之目錄資訊的長度，以位元組為單位。

傳回值

函式會 傳回STATUS_SUCCESS 或錯誤狀態。

備註

以下是 OBJECT_DIRECTORY_INFORMATION 結構的定義。

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

此函式沒有相關聯的匯入程式庫或標頭檔;您必須使用 LoadLibrary 和 GetProcAddress 函式來呼叫它。

規格需求

需求 值
DLL
Ntdll.dll

另請參閱

NtOpenDirectoryObject