Fonction IoCreateSymbolicLink (wdm.h)

  • Article

La routine IoCreateSymbolicLink configure un lien symbolique entre un nom d’objet d’appareil et un nom visible par l’utilisateur pour l’appareil.

Syntaxe

NTSTATUS IoCreateSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

Paramètres

[in] SymbolicLinkName

Pointeur vers une chaîne Unicode mise en mémoire tampon qui est le nom visible par l’utilisateur.

[in] DeviceName

Pointeur vers une chaîne Unicode mise en mémoire tampon qui est le nom de l’objet de périphérique créé par le pilote.

Valeur retournée

IoCreateSymbolicLink retourne STATUS_SUCCESS si l’objet de lien symbolique a été créé.

Remarques

Les pilotes WDM ne nomment pas les objets de périphérique et ne doivent donc pas utiliser cette routine. Au lieu de cela, un pilote WDM doit appeler IoRegisterDeviceInterface pour configurer un lien symbolique.

Pour plus d’informations sur l’utilisation d’IoCreateSymbolicLink, consultez Objets d’appareil nommés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm)

Voir aussi

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface