Fonction ZwQuerySymbolicLinkObject (wdm.h)

Article
02/27/2024

La routine ZwQuerySymbolicLinkObject retourne une chaîne Unicode qui contient la cible d’un lien symbolique.

Syntaxe

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

Paramètres

[in] LinkHandle

Gérez l’objet de lien symbolique que vous souhaitez interroger. Ce handle est créé par un appel réussi à ZwOpenSymbolicLinkObject.

[in, out] LinkTarget

Pointeur vers une chaîne Unicode initialisée qui reçoit la cible du lien symbolique.

[out, optional] ReturnedLength

contient le nombre maximal d’octets à copier dans la chaîne Unicode dans LinkTarget. Lors de la sortie, l’entier long non signé contient la longueur de la chaîne Unicode nommant la cible du lien symbolique.

Valeur retournée

ZwQuerySymbolicLinkObject retourne STATUS_SUCCESS pour indiquer la routine terminée sans erreur ou STATUS_BUFFER_TOO_SMALL si la chaîne Unicode fournie dans LinkTarget est trop petite pour contenir la chaîne retournée.

Remarques

Avant d’appeler cette routine, les rédacteurs de pilotes doivent s’assurer que la chaîne Unicode dans LinkTarget a été correctement initialisée et qu’une mémoire tampon pour la chaîne a été allouée. Les membres MaximumLength et Buffer de la chaîne Unicode doivent être définis avant d’appeler ZwQuerySymbolicLinkObject , sinon l’appel échoue.

Si ZwQuerySymbolicLinkObject retourne STATUS_BUFFER_TOO_SMALL les pilotes doivent examiner la valeur retournée dans ReturnedLength. Le nombre retourné dans cette variable indique la longueur maximale de la chaîne Unicode pour la cible du lien symbolique.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtQuerySymbolicLinkObject » au lieu de « ZwQuerySymbolicLinkObject ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwOpenSymbolicLinkObject

Partager via