SearchResultCollection.Handle Propriedade

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Obtém o identificador retornado pelo IDirectorySearch::ExecuteSearch método que executa a pesquisa real. Para obter mais informações, confira o artigo IDirectorySearch::ExecuteSearch.

public:
 property IntPtr Handle { IntPtr get(); };

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Valor da propriedade

IntPtr

nativeint

O valor ADS_SEARCH_HANDLE que essa coleção usa.

Comentários

O DirectorySearcher que criou essa coleção chama o IDirectorySearch::ExecuteSearch método , que disponibiliza os resultados da consulta para o SearchResultCollection objeto . Para obter mais informações, confira o artigo IDirectorySearch::ExecuteSearch.

Cada vez que uma consulta é executada, um identificador para os resultados dessa consulta é associado ao seu SearchResultCollection objeto . Esse identificador corresponde ao identificador de pesquisa no ADSI. Esse identificador persiste até que você chame o Dispose() método no SearchResultCollection objeto , portanto, você deve chamar Dispose() para evitar uma perda de memória. O coletor de lixo não libera memória para esse objeto específico.