Função IoCreateUnprotectedSymbolicLink (wdm.h)
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) |