Função IoCreateSymbolicLink (wdm.h)

  • Artigo

A rotina IoCreateSymbolicLink configura um vínculo simbólico entre um nome de objeto de dispositivo e um nome visível pelo usuário para o dispositivo.

Sintaxe

NTSTATUS IoCreateSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

Parâmetros

[in] SymbolicLinkName

Ponteiro para uma cadeia de caracteres Unicode em buffer que é o nome visível pelo usuário.

[in] DeviceName

Ponteiro para uma cadeia de caracteres Unicode em buffer que é o nome do objeto de dispositivo criado pelo driver.

Retornar valor

IoCreateSymbolicLink retornará STATUS_SUCCESS se o objeto de link simbólico tiver sido criado.

Comentários

Os drivers WDM não nomeam objetos de dispositivo e, portanto, não devem usar essa rotina. Em vez disso, um driver WDM deve chamar IoRegisterDeviceInterface para configurar um link simbólico.

Para obter mais informações sobre quando usar IoCreateSymbolicLink, consulte Objetos de dispositivo nomeados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm)

Confira também

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface