Função RtlRealSuccessor (ntddk.h)

A rotina RtlRealSuccessor retorna um ponteiro para o sucessor do nó especificado na árvore de link de reprodução.

Sintaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parâmetros

[in] Links

Ponteiro para o nó. O nó deve ter sido inicializado chamando RtlInitializeSplayLinks.

Valor de retorno

RtlRealSuccessor retorna um ponteiro para o sucessor do nó em Linksou NULL se o nó não tiver nenhum sucessor.

Observações

O verdadeiro sucessor de um determinado nó é determinado da seguinte maneira:

• Se o nó determinado tiver uma subárvore direita, o nó mais à esquerda na subárvore direita do nó em Links será o sucessor. Observe que RtlSubtreeSuccessor retorna o mesmo resultado para esse caso.
• Caso contrário, o nó ancestral mais próximo, do qual o nó determinado é um descendente de subárvores à esquerda, é o sucessor.

Os chamadores do Rtl rotinas de link de reprodução são responsáveis por sincronizar o acesso à árvore de link de reprodução. Um mutex rápido é o mecanismo de sincronização mais eficiente a ser usado para essa finalidade.

Os chamadores de rtlRealSuccessor devem estar em execução no IRQL <= DISPATCH_LEVEL se a árvore não forpagada. Normalmente, os chamadores estão em execução no PASSIVE_LEVEL IRQL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Essa rotina está disponível no Microsoft Windows 2000 e posterior.
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	Consulte a seção Comentários.

Consulte também

rtlRealPredecessor

rtlSplay

rtlSubtreeSuccessor