Implementacja podstawowa

Dostawca ADSI obsługuje następujące funkcje:

• Ciągi ADsPath w formacie COM i URL. Z definicji można pobrać obiekt usługi Active Directory przy użyciu ścieżki ADsPath. Dostawcy obsługują składnię wymaganą przez usługę katalogową przy użyciu implementacji ParseDisplayName.
• Obiekt przestrzeni nazw najwyższego poziomu obsługujący IParseDisplayName::P arseDisplayName i IADsOpenDSObject. Ten obiekt zawiera węzły główne dla tej przestrzeni nazw. Część implementacji ParseDisplayName musi zawierać analizator sprawdzający błędy składni dla własnej przestrzeni nazw. Ten obiekt musi również obsługiwać identyfikatory i IADsOpenDSObject.
• Interfejs IADs. Obejmuje to prostą implementację pamięci podręcznej właściwości za pośrednictwem IADs::GetInfo i IADs::SetInfo. Operacje, które pobierają lub ustawiają właściwości obiektu, występują w trybie buforowanym. Wartości pamięci podręcznej są zapisywane w bazowym magazynie katalogów podczas IADs::SetInfo. Jednak metoda ADSI nie jest buforowana, ale jest wykonywana natychmiast.
• Interfejsy IADsPropertyList, IADsPropertyEntry i IADsPropertyValue interfejsy służące do bezpośredniego uzyskiwania dostępu i wyliczania właściwości w pamięci podręcznej właściwości. W przypadku usług katalogowych, które nie uwidaczniają schematu, ten interfejs umożliwia manipulowanie właściwościami obiektu.
• Interfejs IDirectoryObject dla klientów innych niż automatyzacja. Używa protokołu over-the-wire w celu maksymalnej wydajności i pomija pamięć podręczną właściwości.
• Interfejs IADsContainer. Każdy obiekt usługi Active Directory ma kontener nadrzędny, który kontroluje jego okres istnienia. Należy pamiętać, że w przypadku obiektów kontenera usługi ADs IADs::GetInfo wpływa tylko na właściwości kontenera, a nie jego zawartość. Właściwość SetInfo w obiektach kontenera usługi ADs ma wpływ tylko na właściwości kontenera i nie ma wpływu na nowo utworzone obiekty lub obiekty, które już istnieją w kontenerze.
• InterfejsIDispatch. Jest to interfejs automatyzacji dla języków, takich jak Visual Basic Scripting Edition, które nie używają powiązania czasu kompilacji. Powiązane z tym są dane biblioteki typów, które dostawca musi podać. Aby uzyskać więcej informacji, zobacz Problemy z implementacją dostawców ADSI.
• Obiekt kontenera klasy schematu i odpowiednie obiekty składni, właściwości i klas schematu, które obsługują odpowiednio IADsSyntax, IADsPropertyi IADsClass. Co najmniej każdy węzeł główny musi zawierać własny obiekt kontenera klasy schematu.
• Interfejs IADsMembers, jeśli jakiekolwiek obsługiwane atrybuty są kolekcjami obiektów ADSI, takich jak grupy zabezpieczeń.
• Interfejs IADsCollection, jeśli jakiekolwiek obsługiwane atrybuty są kolekcjami tego samego typu elementu katalogu z IADsCollection::Dodaj i IADsCollection::Usuń możliwości.
• Wyliczenie IEnumXXXX obsługuje wszystkie określone obiekty modułu wyliczającego.
• Procedury mapowania składni i konwertowania danych natywnych na VARIANT typu danych.
• Postępuj zgodnie z konwencjami ADSI dla obiektów ADSI dostarczonych przez dostawcę. Uwzględnij pliki pomocy i biblioteki typów dokumentujące właściwości i metody interfejsu.

Podobnie jak w przypadku każdej implementacji modelu COM wywołania QueryInterface muszą zwracać E_NOINTERFACE dla nieimplementowanych interfejsów, E_NOTIMPL dla nieimplementowanych metod interfejsów, które w przeciwnym razie są implementowane i zwracają E_ADS_PROPERTY_NOT_SUPPORTED dla nieimplementowanych właściwości. Aby uzyskać więcej informacji na temat interfejsów podwójnych i ich wpływu na implementację właściwości, zobacz Podwójne interfejsy.