Función IoCreateSymbolicLink (wdm.h)
La rutina IoCreateSymbolicLink configura un vínculo simbólico entre un nombre de objeto de dispositivo y un nombre visible para el usuario para el dispositivo.
Sintaxis
NTSTATUS IoCreateSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parámetros
[in] SymbolicLinkName
Puntero a una cadena Unicode almacenada en búfer que es el nombre visible para el usuario.
[in] DeviceName
Puntero a una cadena Unicode almacenada en búfer que es el nombre del objeto de dispositivo creado por el controlador.
Valor devuelto
IoCreateSymbolicLink devuelve STATUS_SUCCESS si se creó el objeto de vínculo simbólico.
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.
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), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |