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)

Vedi anche

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface