Função IoCreateUnprotectedSymbolicLink (wdm.h)

  • Artigo

A rotina IoCreateUnprotectedSymbolicLink configura um link simbólico desprotegido entre um nome de objeto de dispositivo e um nome visível do Win32 correspondente.

Sintaxe

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

Parâmetros

[in] SymbolicLinkName

Fornece o nome simbólico do link como uma cadeia de caracteres Unicode.

[in] DeviceName

Fornece o nome do objeto do dispositivo ao qual o nome do link simbólico se refere.

Retornar valor

IoCreateUnprotectedSymbolicLink retorna a status final da operação.

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.

IoCreateUnprotectedSymbolicLink poderá ser usado por drivers se o usuário precisar manipular o link simbólico. Por exemplo, os drivers paralelos e serial criam links simbólicos desprotegidos para LPTx e COMx, para que os usuários possam manipulá-los e reatribuí-los usando o comando MODE.

Em geral, os drivers devem chamar essa rotina em vez de IoCreateSymbolicLink se um subsistema protegido permitir que os usuários finais alterem o que um dispositivo nomeado referencia como, por exemplo, ao usar LPT1 para acessar uma impressora de rede.

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), IrqlIoPassive4(wdm), PowerIrpDDis(wdm)

Confira também

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface