Fonction IoCreateSymbolicLink (wdm.h)
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) |