Funzione NtQueryDirectoryObject
[Questa funzione potrebbe essere modificata o non disponibile in futuro.]
Recupera informazioni sull'oggetto directory specificato.
Sintassi
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
);
Parametri
-
DirectoryHandle [in]
-
Handle per l'oggetto directory.
-
Buffer [out, facoltativo]
-
Puntatore a un buffer che riceve le informazioni sulla directory. Questo buffer riceve una o più strutture OBJECT_DIRECTORY_INFORMATION , l'ultima è NULL, seguita da stringhe che contengono i nomi delle voci di directory. Per altre informazioni, vedere la sezione Osservazioni.
-
Lunghezza [in]
-
Dimensioni del buffer di output fornito dall'utente, in byte.
-
ReturnSingleEntry [in]
-
Indica se la funzione deve restituire una sola voce.
-
RestartScan [in]
-
Indica se riavviare l'analisi o continuare l'enumerazione usando le informazioni passate nel parametro Context .
-
Contesto [in, out]
-
Contesto di enumerazione.
-
ReturnLength [out, facoltativo]
-
Puntatore a una variabile che riceve la lunghezza delle informazioni sulla directory restituite nel buffer di output, in byte.
Valore restituito
La funzione restituisce STATUS_SUCCESS o uno stato di errore.
Commenti
Di seguito è riportata la definizione della struttura OBJECT_DIRECTORY_INFORMATION .
typedef struct _OBJECT_DIRECTORY_INFORMATION {
UNICODE_STRING Name;
UNICODE_STRING TypeName;
} OBJECT_DIRECTORY_INFORMATION, *POBJECT_DIRECTORY_INFORMATION;
Questa funzione non ha una libreria di importazione o un file di intestazione associato; è necessario chiamarlo usando le funzioni LoadLibrary e GetProcAddress .
Requisiti
| Requisito | Valore |
|---|---|
| DLL |
|
Vedi anche