Funzione IoCreateUnprotectedSymbolicLink (wdm.h)
La routine IoCreateUnprotectedSymbolicLink configura un collegamento simbolico non protetto tra un nome oggetto dispositivo e un nome visibile Win32 corrispondente.
Sintassi
NTSTATUS IoCreateUnprotectedSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parametri
[in] SymbolicLinkName
Specifica il nome del collegamento simbolico come stringa Unicode.
[in] DeviceName
Specifica il nome dell'oggetto dispositivo a cui fa riferimento il nome del collegamento simbolico.
Valore restituito
IoCreateUnprotectedSymbolicLink restituisce lo stato finale dell'operazione.
Commenti
I driver WDM non denominano gli oggetti dispositivo e pertanto non devono usare questa routine. Al contrario, un driver WDM deve chiamare IoRegisterDeviceInterface per configurare un collegamento simbolico.
IoCreateUnprotectedSymbolicLink può essere usato dai driver se l'utente deve essere in grado di modificare il collegamento simbolico. Ad esempio, i driver paralleli e seriali creano collegamenti simbolici non protetti per LPTx e COMx, in modo che gli utenti possano modificarli e riassegnare usando il comando MODE.
In generale, i driver devono chiamare questa routine anziché IoCreateSymbolicLink se un sottosistema protetto consente agli utenti finali di modificare i riferimenti a un dispositivo denominato, ad esempio quando si usa LPT1 per accedere a una stampante di rete.
Per altre informazioni su quando usare IoCreateSymbolicLink, vedere Oggetti dispositivo denominati.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |