Funzione ZwQuerySymbolicLinkObject (wdm.h)

Articolo
03/08/2023

La routine ZwQuerySymbolicLinkObject restituisce una stringa Unicode che contiene la destinazione di un collegamento simbolico.

Sintassi

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

Parametri

[in] LinkHandle

Gestire l'oggetto di collegamento simbolico su cui si desidera eseguire una query. Questo handle viene creato da una chiamata riuscita a ZwOpenSymbolicLinkObject.

[in, out] LinkTarget

Puntatore a una stringa Unicode inizializzata che riceve la destinazione del collegamento simbolico.

[out, optional] ReturnedLength

contiene il numero massimo di byte da copiare nella stringa Unicode in LinkTarget. Nell'output, l'intero long senza segno contiene la lunghezza della stringa Unicode che denomina la destinazione del collegamento simbolico.

Valore restituito

ZwQuerySymbolicLinkObject restituisce STATUS_SUCCESS per indicare che la routine è stata completata senza errori o STATUS_BUFFER_TOO_SMALL se la stringa Unicode fornita in LinkTarget è troppo piccola per contenere la stringa restituita.

Commenti

Prima di chiamare questa routine, i writer di driver devono assicurarsi che la stringa Unicode in LinkTarget sia stata inizializzata correttamente e che sia stato allocato un buffer per la stringa. I membri MaximumLength e Buffer della stringa Unicode devono essere impostati prima di chiamare ZwQuerySymbolicLinkObject o la chiamata avrà esito negativo.

Se ZwQuerySymbolicLinkObject restituisce STATUS_BUFFER_TOO_SMALL driver devono esaminare il valore restituito in ReturnedLength. Il numero restituito in questa variabile indica la lunghezza massima della stringa Unicode per la destinazione del collegamento simbolico.

Se la chiamata a questa funzione si verifica in modalità utente, è necessario usare il nome "NtQuerySymbolicLinkObject" anziché "ZwQuerySymbolicLinkObject".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwOpenSymbolicLinkObject

Condividi tramite