Fonction IoCreateUnprotectedSymbolicLink (wdm.h)
La routine IoCreateUnprotectedSymbolicLink configure un lien symbolique non protégé entre un nom d’objet d’appareil et un nom win32-visible correspondant.
Syntaxe
NTSTATUS IoCreateUnprotectedSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Paramètres
[in] SymbolicLinkName
Fournit le nom du lien symbolique sous forme de chaîne Unicode.
[in] DeviceName
Fournit le nom de l’objet d’appareil auquel le nom de lien symbolique fait référence.
Valeur retournée
IoCreateUnprotectedSymbolicLink retourne la status finale de l’opération.
Remarques
Les pilotes WDM ne nomment pas d’objets d’appareil et ne doivent donc pas utiliser cette routine. Au lieu de cela, un pilote WDM doit appeler IoRegisterDeviceInterface pour configurer un lien symbolique.
IoCreateUnprotectedSymbolicLink peut être utilisé par les pilotes si l’utilisateur doit pouvoir manipuler le lien symbolique. Par exemple, les pilotes parallèle et série créent des liens symboliques non protégés pour LPTx et COMx, afin que les utilisateurs puissent les manipuler et les réaffecter à l’aide de la commande MODE.
En général, les pilotes doivent appeler cette routine au lieu d’IoCreateSymbolicLink si un sous-système protégé permet aux utilisateurs finaux de modifier ce que fait référence un appareil nommé, par exemple, lors de l’utilisation de LPT1 pour accéder à une imprimante réseau.
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 (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport),IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |