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
Usando versões Nt e Zw das rotinas de serviços do sistema nativo