ZwQuerySymbolicLinkObject 函式 (wdm.h)

  • 發行項

ZwQuerySymbolicLinkObject 例程會傳回 Unicode 字串，其中包含符號鏈接的目標。

語法

NTSYSAPI NTSTATUS ZwQuerySymbolicLinkObject(
  [in]            HANDLE          LinkHandle,
  [in, out]       PUNICODE_STRING LinkTarget,
  [out, optional] PULONG          ReturnedLength
);

參數

[in] LinkHandle

您要查詢的符號連結物件句柄。 此句柄是由 成功呼叫 ZwOpenSymbolicLinkObject 所建立。

[in, out] LinkTarget

接收符號連結目標的初始化 Unicode 字串指標。

[out, optional] ReturnedLength

包含要複製到 LinkTarget 之 Unicode 字串的最大位元元組數目。 在輸出上，不帶正負號的長整數包含 Unicode 字串的長度，命名符號鏈接的目標。

傳回值

ZwQuerySymbolicLinkObject 會傳回STATUS_SUCCESS表示例程未發生錯誤或STATUS_BUFFER_TOO_SMALL如果 LinkTarget 提供的 Unicode 字符串太小而無法保存傳回的字符串。

備註

呼叫此例程之前，驅動程式寫入器必須確定已正確初始化 LinkTarget 上的Unicode字串，並已配置字串的緩衝區。 必須先設定 Unicode 字串 的 MaximumLength 和 Buffer 成員，才能呼叫 ZwQuerySymbolicLinkObject ，否則呼叫將會失敗。

如果 ZwQuerySymbolicLinkObject 傳回STATUS_BUFFER_TOO_SMALL驅動程式應該檢查 ReturnedLength 傳回的值。 此變數中傳回的數位表示符號連結目標 Unicode 字串的最大長度。

如果呼叫此函式發生在使用者模式中，您應該使用名稱 「NtQuerySymbolicLinkObject」，而不是 「ZwQuerySymbolicLinkObject」。。

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。

規格需求

需求 值
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm)

另請參閱

使用原生系統服務例程的 Nt 和 Zw 版本

ZwOpenSymbolicLinkObject