Função IoCreateUnprotectedSymbolicLink (wdm.h)
A rotina IoCreateUnprotectedSymbolicLink configura um vínculo simbólico desprotegido entre um nome de objeto do 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 do link simbólico 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.
Valor de retorno
IoCreateUnprotectedSymbolicLink retorna o status final da operação.
Observações
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 pode ser usada por drivers se o usuário precisar ser capaz de 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 faz referência 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |