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