Función IoCreateUnprotectedSymbolicLink (wdm.h)

La rutina IoCreateUnprotectedSymbolicLink configura un vínculo simbólico desprotegido entre un nombre de objeto de dispositivo y un nombre visible 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.

Observaciones

Los controladores WDM no asignan nombres a 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 necesita 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 lo que hace referencia a un dispositivo con nombre como, por ejemplo, al usar 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

Consulte también

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface