Función IoCreateSymbolicLink (wdm.h)

  • Artículo

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)

Consulte también

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface