PrincipalSearcher.FindOne Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca główny wynik wyszukiwania zawierający pierwszy obiekt podmiotu zabezpieczeń, który jest zgodny z podmiotem zabezpieczeń określonym we QueryFilter właściwości.
public:
System::DirectoryServices::AccountManagement::Principal ^ FindOne();public System.DirectoryServices.AccountManagement.Principal FindOne ();[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.PrincipalPublic Function FindOne () As PrincipalZwraca
Principal Obiekt zawierający obiekt zabezpieczeń zgodny z filtrem zapytania lub null jeśli nie zostaną znalezione żadne wyniki.
- Atrybuty
Wyjątki
Zawiera QueryFilter właściwości odwołania. Aby uzyskać więcej informacji, zobacz temat Omówienie zapytania według przykładu .
Jest QueryFilter to utrwalone podmioty zabezpieczeń.
Przed QueryFilter wykonaniem zapytania należy najpierw przypisać element do głównego wyszukiwania.
Uwagi
Jeśli w obiekcie QueryFilterokreślono dokładnie jedno dopasowanie obiektu , ta metoda zwraca ten obiekt. Jeśli istnieje wiele dopasowań QueryFilter obiektu, ta metoda arbitralnie zwraca jedną z pasujących podmiotów zabezpieczeń.
Obiekt Principal zwrócony z tej metody odpowiada typowi obiektu zawartego QueryFilter we właściwości. Wyszukiwanie jest przeprowadzane w kontekście określonym we Context właściwości. Aby uzyskać więcej informacji, zobacz temat Omówienie zapytania według przykładu .
