Compartilhar via


Função NtOpenSymbolicLinkObject

[Essa função pode estar alterada ou indisponível no futuro.]

Abre um link simbólico existente.

Sintaxe

NTSTATUS WINAPI NtOpenSymbolicLinkObject(
  _Out_ PHANDLE            LinkHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes
);

Parâmetros

LinkHandle [out]

Um identificador para o objeto de link simbólico recém-aberto.

DesiredAccess [in]

Um ACCESS_MASK que especifica o acesso solicitado ao objeto de diretório. É comum usar GENERIC_READ para que o identificador possa ser passado para a função NtQueryDirectoryObject .

ObjectAttributes [in]

Os atributos do objeto de diretório. Para inicializar a estrutura OBJECT_ATTRIBUTES , use a macro InitializeObjectAttributes . Se o chamador não estiver em execução em um contexto de thread do sistema, ele deverá especificar o sinalizador OBJ_KERNEL_HANDLE ao inicializar a estrutura. Para obter mais informações, consulte a documentação desses itens na documentação do WDK.

Valor retornado

A função retorna STATUS_SUCCESS ou um erro status.

Comentários

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito Valor
DLL
Ntdll.dll

Confira também

NtQueryDirectoryObject