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)

Vedi anche

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface