次の方法で共有

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]

ディレクトリ オブジェクトへのハンドル。

Buffer [out, optional]

ディレクトリ情報を受け取るバッファーへのポインター。 このバッファーは、1 つ以上 のOBJECT_DIRECTORY_INFORMATION 構造体 (最後の構造体は NULL)、その後にディレクトリ エントリの名前を含む文字列を受け取ります。 詳細については、「解説」を参照してください。

長さ [入力]

ユーザー指定の出力バッファーのサイズ (バイト単位)。

ReturnSingleEntry [in]

関数が 1 つのエントリのみを返す必要があるかどうかを示します。

RestartScan [in]

Context パラメーターで渡された情報を使用して、スキャンを再起動するか、列挙を続行するかを示します。

コンテキスト [入力、出力]

列挙コンテキスト。

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