Udostępnij za pośrednictwem

Uzyskiwanie dostępu do danych za pomocą interfejsu ADSI i manipulowanie nimi

  • Artykuł

Wszystkie obiekty mają właściwości. Wszystkie obiekty COM interfejsu usługi Active Directory (ADSI) mają co najmniej jeden interfejs z metodami pobierającymi właściwości obiektu katalogu reprezentowanego przez obiekt COM. Istnieje wiele sposobów odczytywania właściwości z obiektu:

  • Pobierz określoną właściwość według nazwy: interfejs IADs ma dwie metody IADs::Get i IADs::GetEx do odczytu określonej właściwości. Każdy obiekt ADSI COM ma interfejs IADs.
  • Pobierz określoną listę właściwości: interfejs IDirectoryObject ma metodę IDirectoryObject::GetObjectAttributes, która umożliwia określenie listy zawierającej nazwy właściwości do odczytu i zwraca tablicę struktur zawierających żądane wartości właściwości.
  • Wyliczanie wszystkich właściwości obiektu: interfejs IADsPropertyList umożliwia wyliczanie wszystkich właściwości obiektu.
  • Uzyskiwanie właściwości specjalnych: interfejsy automatyzacji (IADs*) mają metody właściwości, które umożliwiają uzyskanie właściwości specjalnych, które nie są przechowywane w obiekcie. Lub metody właściwości mogą umożliwić uzyskanie właściwości obiektu w formacie danych, który różni się od rzeczywistego typu danych przechowywanych. Na przykład interfejs IADs ma metody właściwości, takie jak IADs::get_Name, które pobierają względną nazwę wyróżniającą obiektu (RDN); IADs::get_Class, które pobierają klasę obiektu oraz IADs::get_Parent, które pobierają ścieżkę ADsPath do nadrzędnego obiektu.

Narzędzie ADSI umożliwia buforowanie właściwości lokalnie po ich odczytaniu z serwera katalogów. Dzięki temu można odczytać właściwości z lokalnej pamięci podręcznej właściwości lub pobrać właściwości bezpośrednio z serwera katalogów. AdsI ma również metody aktualizowania pamięci podręcznej, a także określania, czy wszystkie właściwości obiektu są buforowane, czy tylko te, które zostały określone.

Po pobraniu właściwości odczytasz jej wartość. Typ danych właściwości zależy od definicji właściwości (znanej również jako atrybut) w schemacie usługi Active Directory. Dla każdego typu właściwości, która może istnieć w usłudze Active Directory, istnieje obiekt atrybutSchema w schemacie usługi Active Directory. Obiekt atrybutSchema definiuje cechy atrybutu. Jedną z tych cech jest składnia atrybutu, która określa typ danych wartości atrybutu. Aby uzyskać więcej informacji, zobacz Charakterystyka atrybutów i składni atrybutów usługi Active Directory.

Interfejsy automatyzacji (IADs*) zwracają wartość właściwości jako VARIANT lub wskaźnik do interfejsu automatyzacji na obiekcie COM, który reprezentuje właściwość. Interfejsy IDirectoryObject i IDirectorySearch zwracają właściwość jako wskaźnik do struktury zawierającej wartość właściwości o określonym typie lub wskaźnik do ciągu bajtów. Ponadto IDirectoryObject i IDirectorySearch pobierają właściwości bezpośrednio z serwera katalogowego zamiast używać lokalnej pamięci podręcznej właściwości.

W tej sekcji opisano następujące tematy: