Función IoCreateUnprotectedSymbolicLink (wdm.h)
La rutina IoCreateUnprotectedSymbolicLink configura un vínculo simbólico no protegido entre un nombre de objeto de dispositivo y un nombre visible de Win32 correspondiente.
Sintaxis
NTSTATUS IoCreateUnprotectedSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parámetros
[in] SymbolicLinkName
Proporciona el nombre del vínculo simbólico como una cadena Unicode.
[in] DeviceName
Proporciona el nombre del objeto de dispositivo al que hace referencia el nombre del vínculo simbólico.
Valor devuelto
IoCreateUnprotectedSymbolicLink devuelve el estado final de la operación.
Comentarios
Los controladores WDM no asignan nombres a los objetos de dispositivo y, por lo tanto, no deben usar esta rutina. En su lugar, un controlador WDM debe llamar a IoRegisterDeviceInterface para configurar un vínculo simbólico.
Los controladores pueden usar IoCreateUnprotectedSymbolicLink si el usuario debe poder manipular el vínculo simbólico. Por ejemplo, los controladores paralelos y serie crean vínculos simbólicos no protegidos para LPTx y COMx, para que los usuarios puedan manipularlos y reasignarlos mediante el comando MODE.
En general, los controladores deben llamar a esta rutina en lugar de IoCreateSymbolicLink si un subsistema protegido permite a los usuarios finales cambiar las referencias de un dispositivo con nombre como, por ejemplo, cuando se usa LPT1 para acceder a una impresora de red.
Para obtener más información sobre cuándo usar IoCreateSymbolicLink, vea Objetos de dispositivo con nombre.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |