Função ZwOpenSymbolicLinkObject (wdm.h)

A rotina ZwOpenSymbolicLinkObject abre um link simbólico existente.

Sintaxe

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

Parâmetros

[out] LinkHandle

Ponteiro para uma variável HANDLE que recebe um identificador para o objeto de link simbólico.

[in] DesiredAccess

Especifica um valor ACCESS_MASK que determina o acesso solicitado ao objeto . O chamador geralmente especificava GENERIC_READ, para que o identificador possa ser passado para ZwQuerySymbolicLinkObject.

[in] ObjectAttributes

Ponteiro para uma estrutura OBJECT_ATTRIBUTES que especifica o nome do objeto e outros atributos. Use InitializeObjectAttributes para inicializar essa estrutura. Se o chamador não estiver em execução em um contexto de thread do sistema, ele deverá definir o atributo OBJ_KERNEL_HANDLE quando chamar InitializeObjectAttributes.

Retornar valor

ZwOpenSymbolicLinkObject retorna STATUS_SUCCESS com êxito ou o erro apropriado status.

Comentários

Depois que o identificador apontado por LinkHandle não estiver mais em uso, o driver deverá chamar ZwClose para fechá-lo.

Se o chamador não estiver em execução em um contexto de thread do sistema, ele deverá garantir que todos os identificadores que ele cria sejam identificadores privados. Caso contrário, o identificador pode ser acessado pelo processo em cujo contexto o driver está em execução. Para obter mais informações, consulte Identificadores de objeto.

Se a chamada para a função ZwOpenSymbolicLinkObject ocorrer no modo de usuário, você deverá usar o nome "NtOpenSymbolicLinkObject" em vez de "ZwOpenSymbolicLinkObject".

NtOpenSymbolicLinkObject e ZwOpenSymbolicLinkObject são duas versões da mesma rotina dos Serviços do Sistema Nativo do Windows. A rotina NtOpenSymbolicLinkObject no kernel do Windows não está diretamente acessível para drivers no modo kernel. No entanto, os drivers de modo kernel podem acessar essa rotina indiretamente chamando a rotina ZwOpenSymbolicLinkObject .

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

ACCESS_MASK

InitializeObjectAttributes

Usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwQuerySymbolicLinkObject