Funzione IoCreateSymbolicLink (wdm.h)
La routine IoCreateSymbolicLink configura un collegamento simbolico tra un nome oggetto dispositivo e un nome visibile dall'utente per il dispositivo.
Sintassi
NTSTATUS IoCreateSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parametri
[in] SymbolicLinkName
Puntatore a una stringa Unicode memorizzata nel buffer che corrisponde al nome visibile all'utente.
[in] DeviceName
Puntatore a una stringa Unicode memorizzata nel buffer che corrisponde al nome dell'oggetto dispositivo creato dal driver.
Valore restituito
IoCreateSymbolicLink restituisce STATUS_SUCCESS se è stato creato l'oggetto collegamento simbolico.
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.
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 | HwStorPortProhibitedDDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |