Función IoCreateUnprotectedSymbolicLink (wdm.h)

  • Artículo

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)

Consulte también

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface