Funzione ZwOpenSymbolicLinkObject (wdm.h)

  • Articolo

La routine ZwOpenSymbolicLinkObject apre un collegamento simbolico esistente.

Sintassi

NTSYSAPI NTSTATUS ZwOpenSymbolicLinkObject(
  [out] PHANDLE            LinkHandle,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes
);

Parametri

[out] LinkHandle

Puntatore a una variabile HANDLE che riceve un handle per l'oggetto collegamento simbolico.

[in] DesiredAccess

Specifica un valore ACCESS_MASK che determina l'accesso richiesto all'oggetto. Il chiamante in genere ha specificato GENERIC_READ, in modo che l'handle possa essere passato a ZwQuerySymbolicLinkObject.

[in] ObjectAttributes

Puntatore a una struttura OBJECT_ATTRIBUTES che specifica il nome dell'oggetto e altri attributi. Usare InitializeObjectAttributes per inizializzare questa struttura. Se il chiamante non è in esecuzione in un contesto di thread di sistema, deve impostare l'attributo OBJ_KERNEL_HANDLE quando chiama InitializeObjectAttributes.

Valore restituito

ZwOpenSymbolicLinkObject restituisce STATUS_SUCCESS in caso di esito positivo o dello stato di errore appropriato.

Commenti

Quando l'handle a cui punta LinkHandle non è più in uso, il driver deve chiamare ZwClose per chiuderlo.

Se il chiamante non è in esecuzione in un contesto di thread di sistema, deve assicurarsi che gli handle creati siano handle privati. In caso contrario, l'handle può essere accessibile dal processo nel cui contesto è in esecuzione il driver. Per altre informazioni, vedere Handle di oggetti.

Se la chiamata alla funzione ZwOpenSymbolicLinkObject si verifica in modalità utente, è necessario usare il nome "NtOpenSymbolicLinkObject" anziché "ZwOpenSymbolicLinkObject".

NtOpenSymbolicLinkObject e ZwOpenSymbolicLinkObject sono due versioni della stessa routine di Servizi di sistema nativi di Windows. La routine NtOpenSymbolicLinkObject nel kernel di Windows non è direttamente accessibile ai driver in modalità kernel. Tuttavia, i driver in modalità kernel possono accedere indirettamente a questa routine chiamando la routine ZwOpenSymbolicLinkObject .

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito Valore
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), PowerIrpDDis(wdm)

Vedi anche

ACCESS_MASK

InitializeObjectAttributes

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwQuerySymbolicLinkObject