include/iads.idl

   1 /*
   2  * Copyright 2005 Francois Gouget
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 import "oaidl.idl";
  20
  21 #ifndef __WIDL__
  22 #define threading(model)
  23 #define progid(str)
  24 #define vi_progid(str)
  25 #endif
  26
  27 [
  28     helpstring("Active DS Type Library"),
  29     uuid(97d25db0-0363-11cf-abc4-02608c9e7553),
  30     version(1.0)
  31 ]
  32 library ActiveDs
  33 {
  34
  35 importlib("stdole2.tlb");
  36
  37 typedef enum
  38 {
  39     ADS_RIGHT_DS_CREATE_CHILD         = 0x00000001,
  40     ADS_RIGHT_DS_DELETE_CHILD         = 0x00000002,
  41     ADS_RIGHT_ACTRL_DS_LIST           = 0x00000004,
  42     ADS_RIGHT_DS_SELF                 = 0x00000008,
  43     ADS_RIGHT_DS_READ_PROP            = 0x00000010,
  44     ADS_RIGHT_DS_WRITE_PROP           = 0x00000020,
  45     ADS_RIGHT_DS_DELETE_TREE          = 0x00000040,
  46     ADS_RIGHT_DS_LIST_OBJECT          = 0x00000080,
  47     ADS_RIGHT_DS_CONTROL_ACCESS       = 0x00000100,
  48
  49     ADS_RIGHT_DELETE                  = 0x00010000,
  50     ADS_RIGHT_READ_CONTROL            = 0x00020000,
  51     ADS_RIGHT_WRITE_DAC               = 0x00040000,
  52     ADS_RIGHT_WRITE_OWNER             = 0x00080000,
  53     ADS_RIGHT_SYNCHRONIZE             = 0x00100000,
  54     ADS_RIGHT_ACCESS_SYSTEM_SECURITY  = 0x00200000,
  55
  56     ADS_RIGHT_GENERIC_ALL             = 0x10000000,
  57     ADS_RIGHT_GENERIC_EXECUTE         = 0x20000000,
  58     ADS_RIGHT_GENERIC_WRITE           = 0x40000000,
  59     ADS_RIGHT_GENERIC_READ            = 0x80000000
  60 } ADS_RIGHTS_ENUM;
  61
  62 typedef enum
  63 {
  64     ADS_SECURE_AUTHENTICATION     = 0x1,
  65     ADS_USE_ENCRYPTION            = 0x2,
  66     ADS_USE_SSL                   = 0x2,
  67     ADS_READONLY_SERVER           = 0x4,
  68     ADS_PROMPT_CREDENTIALS        = 0x8,
  69     ADS_NO_AUTHENTICATION         = 0x10,
  70     ADS_FAST_BIND                 = 0x20,
  71     ADS_USE_SIGNING               = 0x40,
  72     ADS_USE_SEALING               = 0x80,
  73     ADS_USE_DELEGATION            = 0x100,
  74     ADS_SERVER_BIND               = 0x200,
  75     ADS_NO_REFERRAL_CHASING       = 0x400,
  76     ADS_AUTH_RESERVED             = 0x80000000
  77 } ADS_AUTHENTICATION_ENUM;
  78
  79 typedef enum
  80 {
  81     ADS_SEARCHPREF_ASYNCHRONOUS,
  82     ADS_SEARCHPREF_DEREF_ALIASES,
  83     ADS_SEARCHPREF_SIZE_LIMIT,
  84     ADS_SEARCHPREF_TIME_LIMIT,
  85     ADS_SEARCHPREF_ATTRIBTYPES_ONLY,
  86     ADS_SEARCHPREF_SEARCH_SCOPE,
  87     ADS_SEARCHPREF_TIMEOUT,
  88     ADS_SEARCHPREF_PAGESIZE,
  89     ADS_SEARCHPREF_PAGED_TIME_LIMIT,
  90     ADS_SEARCHPREF_CHASE_REFERRALS,
  91     ADS_SEARCHPREF_SORT_ON,
  92     ADS_SEARCHPREF_CACHE_RESULTS,
  93     ADS_SEARCHPREF_DIRSYNC,
  94     ADS_SEARCHPREF_TOMBSTONE,
  95     ADS_SEARCHPREF_VLV,
  96     ADS_SEARCHPREF_ATTRIBUTE_QUERY,
  97     ADS_SEARCHPREF_SECURITY_MASK,
  98     ADS_SEARCHPREF_DIRSYNC_FLAG,
  99     ADS_SEARCHPREF_EXTENDED_DN
 100 } ADS_SEARCHPREF_ENUM;
 101
 102 typedef enum
 103 {
 104     ADS_STATUS_S_OK,
 105     ADS_STATUS_INVALID_SEARCHPREF,
 106     ADS_STATUS_INVALID_SEARCHPREFVALUE
 107 } ADS_STATUSENUM;
 108
 109 typedef enum
 110 {
 111     ADSTYPE_INVALID,
 112     ADSTYPE_DN_STRING,
 113     ADSTYPE_CASE_EXACT_STRING,
 114     ADSTYPE_CASE_IGNORE_STRING,
 115     ADSTYPE_PRINTABLE_STRING,
 116     ADSTYPE_NUMERIC_STRING,
 117     ADSTYPE_BOOLEAN,
 118     ADSTYPE_INTEGER,
 119     ADSTYPE_OCTET_STRING,
 120     ADSTYPE_UTC_TIME,
 121     ADSTYPE_LARGE_INTEGER,
 122     ADSTYPE_PROV_SPECIFIC,
 123     ADSTYPE_OBJECT_CLASS,
 124     ADSTYPE_CASEIGNORE_LIST,
 125     ADSTYPE_OCTET_LIST,
 126     ADSTYPE_PATH,
 127     ADSTYPE_POSTALADDRESS,
 128     ADSTYPE_TIMESTAMP,
 129     ADSTYPE_BACKLINK,
 130     ADSTYPE_TYPEDNAME,
 131     ADSTYPE_HOLD,
 132     ADSTYPE_NETADDRESS,
 133     ADSTYPE_REPLICAPOINTER,
 134     ADSTYPE_FAXNUMBER,
 135     ADSTYPE_EMAIL,
 136     ADSTYPE_NT_SECURITY_DESCRIPTOR,
 137     ADSTYPE_UNKNOWN,
 138     ADSTYPE_DN_WITH_BINARY,
 139     ADSTYPE_DN_WITH_STRING
 140 } ADSTYPEENUM;
 141
 142 typedef enum
 143 {
 144     ADS_SCOPE_BASE,
 145     ADS_SCOPE_ONELEVEL,
 146     ADS_SCOPE_SUBTREE
 147 } ADS_SCOPEENUM;
 148
 149 typedef enum
 150 {
 151     ADS_PASSWORD_ENCODE_REQUIRE_SSL,
 152     ADS_PASSWORD_ENCODE_CLEAR
 153 } ADS_PASSWORD_ENCODING_ENUM;
 154
 155 typedef struct _ADS_CASEIGNORE_LIST
 156 {
 157     struct _ADS_CASEIGNORE_LIST *Next;
 158     LPWSTR String;
 159 } ADS_CASEIGNORE_LIST;
 160
 161 typedef struct _ADS_OCTET_LIST
 162 {
 163     struct _ADS_OCTET_LIST *Next;
 164     DWORD Length;
 165     BYTE *Data;
 166 } ADS_OCTET_LIST;
 167
 168 typedef struct
 169 {
 170     DWORD Type;
 171     LPWSTR VolumeName;
 172     LPWSTR Path;
 173 } ADS_PATH, *PADS_PATH;
 174
 175 typedef struct
 176 {
 177     DWORD WholeSeconds;
 178     DWORD EventID;
 179 } ADS_TIMESTAMP;
 180
 181
 182 typedef ADSTYPEENUM ADSTYPE;
 183 typedef LPWSTR ADS_DN_STRING;
 184 typedef LPWSTR *PADS_DN_STRING;
 185 typedef LPWSTR ADS_CASE_EXACT_STRING;
 186 typedef LPWSTR *PADS_CASE_EXACT_STRING;
 187 typedef LPWSTR ADS_CASE_IGNORE_STRING;
 188 typedef LPWSTR *PADS_CASE_IGNORE_STRING;
 189 typedef LPWSTR ADS_PRINTABLE_STRING;
 190 typedef LPWSTR *PADS_PRINTABLE_STRING;
 191 typedef LPWSTR ADS_NUMERIC_STRING;
 192 typedef LPWSTR *PADS_NUMERIC_STRING;
 193 typedef DWORD ADS_BOOLEAN;
 194 typedef DWORD *LPNDS_BOOLEAN;
 195 typedef DWORD ADS_INTEGER;
 196 typedef DWORD *PADS_INTEGER;
 197 typedef SYSTEMTIME ADS_UTC_TIME;
 198 typedef SYSTEMTIME *PADS_UTC_TIME;
 199 typedef LARGE_INTEGER ADS_LARGE_INTEGER;
 200 typedef LARGE_INTEGER *PADS_LARGE_INTEGER;
 201 typedef LPWSTR ADS_OBJECT_CLASS;
 202 typedef LPWSTR *PADS_OBJECT_CLASS;
 203 typedef struct _ADS_OCTET_LIST *PADS_OCTET_LIST;
 204 typedef struct _ADS_CASEIGNORE_LIST *PADS_CASEIGNORE_LIST;
 205 typedef ADS_STATUSENUM ADS_STATUS;
 206 typedef ADS_SEARCHPREF_ENUM ADS_SEARCHPREF;
 207 typedef HANDLE ADS_SEARCH_HANDLE;
 208 typedef HANDLE *PADS_SEARCH_HANDLE;
 209
 210
 211 typedef struct
 212 {
 213     DWORD dwLength;
 214     BYTE *lpValue;
 215 } ADS_OCTET_STRING;
 216
 217 typedef struct
 218 {
 219     DWORD dwLength;
 220     BYTE *lpValue;
 221 } ADS_PROV_SPECIFIC;
 222
 223 typedef struct
 224 {
 225     LPWSTR PostalAddress[ 6 ];
 226 } ADS_POSTALADDRESS, *PADS_POSTALADDRESS;
 227
 228 typedef struct
 229 {
 230     LPWSTR ObjectName;
 231     DWORD Level;
 232     DWORD Interval;
 233 } ADS_TYPEDNAME, *PADS_TYPEDNAME;
 234
 235 typedef struct
 236 {
 237     DWORD RemoteID;
 238     LPWSTR ObjectName;
 239 } ADS_BACKLINK;
 240
 241 typedef struct
 242 {
 243     LPWSTR ObjectName;
 244     DWORD Amount;
 245 } ADS_HOLD;
 246
 247 typedef struct
 248 {
 249     DWORD AddressType;
 250     DWORD AddressLength;
 251     BYTE *Address;
 252 } ADS_NETADDRESS, *PADS_NETADDRESS;
 253
 254 typedef struct
 255 {
 256     LPWSTR ServerName;
 257     DWORD ReplicaType;
 258     DWORD ReplicaNumber;
 259     DWORD Count;
 260     PADS_NETADDRESS ReplicaAddressHints;
 261 } ADS_REPLICAPOINTER, *PADS_REPLICAPOINTER;
 262
 263 typedef struct
 264 {
 265     LPWSTR TelephoneNumber;
 266     DWORD NumberOfBits;
 267     BYTE *Parameters;
 268 } ADS_FAXNUMBER, *PADS_FAXNUMBER;
 269
 270
 271 typedef struct
 272 {
 273     LPWSTR Address;
 274     DWORD Type;
 275 } ADS_EMAIL, *PADS_EMAIL;
 276
 277 typedef struct
 278 {
 279     DWORD dwLength;
 280     BYTE *lpValue;
 281 } ADS_NT_SECURITY_DESCRIPTOR;
 282
 283 typedef struct
 284 {
 285     DWORD dwLength;
 286     BYTE *lpBinaryValue;
 287     LPWSTR pszDNString;
 288 } ADS_DN_WITH_BINARY, *PADS_DN_WITH_BINARY;
 289
 290 typedef struct
 291 {
 292     LPWSTR pszStringValue;
 293     LPWSTR pszDNString;
 294 } ADS_DN_WITH_STRING, *PADS_DN_WITH_STRING;
 295
 296 typedef struct _adsvalue
 297 {
 298     ADSTYPE dwType;
 299     union
 300     {
 301         ADS_DN_STRING DNString;
 302         ADS_CASE_EXACT_STRING CaseExactString;
 303         ADS_CASE_IGNORE_STRING CaseIgnoreString;
 304         ADS_PRINTABLE_STRING PrintableString;
 305         ADS_NUMERIC_STRING NumericString;
 306         ADS_BOOLEAN Boolean;
 307         ADS_INTEGER Integer;
 308         ADS_OCTET_STRING OctetString;
 309         ADS_UTC_TIME UTCTime;
 310         ADS_LARGE_INTEGER LargeInteger;
 311         ADS_OBJECT_CLASS ClassName;
 312         ADS_PROV_SPECIFIC ProviderSpecific;
 313         PADS_CASEIGNORE_LIST pCaseIgnoreList;
 314         PADS_OCTET_LIST pOctetList;
 315         PADS_PATH pPath;
 316         PADS_POSTALADDRESS pPostalAddress;
 317         ADS_TIMESTAMP Timestamp;
 318         ADS_BACKLINK BackLink;
 319         PADS_TYPEDNAME pTypedName;
 320         ADS_HOLD Hold;
 321         PADS_NETADDRESS pNetAddress;
 322         PADS_REPLICAPOINTER pReplicaPointer;
 323         PADS_FAXNUMBER pFaxNumber;
 324         ADS_EMAIL Email;
 325         ADS_NT_SECURITY_DESCRIPTOR SecurityDescriptor;
 326         PADS_DN_WITH_BINARY pDNWithBinary;
 327         PADS_DN_WITH_STRING pDNWithString;
 328     } DUMMYUNIONNAME;
 329 } ADSVALUE, *PADSVALUE;
 330
 331 typedef struct ads_searchpref_info
 332 {
 333     ADS_SEARCHPREF dwSearchPref;
 334     ADSVALUE vValue;
 335     ADS_STATUS dwStatus;
 336 } ADS_SEARCHPREF_INFO, *PADS_SEARCHPREF_INFO;
 337
 338 typedef struct ads_search_column
 339 {
 340     LPWSTR pszAttrName;
 341     ADSTYPE dwADsType;
 342     PADSVALUE pADsValues;
 343     DWORD dwNumValues;
 344     HANDLE hReserved;
 345 } ADS_SEARCH_COLUMN, *PADS_SEARCH_COLUMN;
 346
 347 typedef struct _ads_object_info
 348 {
 349     LPWSTR pszRDN;
 350     LPWSTR pszObjectDN;
 351     LPWSTR pszParentDN;
 352     LPWSTR pszSchemaDN;
 353     LPWSTR pszClassName;
 354 } ADS_OBJECT_INFO, *PADS_OBJECT_INFO;
 355
 356 typedef struct _ads_attr_info
 357 {
 358     LPWSTR pszAttrName;
 359     DWORD dwControlCode;
 360     ADSTYPE dwADsType;
 361     PADSVALUE pADsValues;
 362     DWORD dwNumValues;
 363 } ADS_ATTR_INFO, *PADS_ATTR_INFO;
 364
 365 typedef enum
 366 {
 367     ADS_SECURITY_INFO_OWNER = 0x1,
 368     ADS_SECURITY_INFO_GROUP = 0x2,
 369     ADS_SECURITY_INFO_DACL  = 0x4,
 370     ADS_SECURITY_INFO_SACL  = 0x8
 371 } ADS_SECURITY_INFO_ENUM;
 372
 373 typedef enum
 374 {
 375     ADS_SETTYPE_FULL = 1,
 376     ADS_SETTYPE_PROVIDER = 2,
 377     ADS_SETTYPE_SERVER = 3,
 378     ADS_SETTYPE_DN = 4
 379 } ADS_SETTYPE_ENUM;
 380
 381 typedef enum
 382 {
 383     ADS_FORMAT_WINDOWS = 1,
 384     ADS_FORMAT_WINDOWS_NO_SERVER = 2,
 385     ADS_FORMAT_WINDOWS_DN = 3,
 386     ADS_FORMAT_WINDOWS_PARENT = 4,
 387     ADS_FORMAT_X500 = 5,
 388     ADS_FORMAT_X500_NO_SERVER = 6,
 389     ADS_FORMAT_X500_DN = 7,
 390     ADS_FORMAT_X500_PARENT = 8,
 391     ADS_FORMAT_SERVER = 9,
 392     ADS_FORMAT_PROVIDER = 10,
 393     ADS_FORMAT_LEAF = 11
 394 } ADS_FORMAT_ENUM;
 395
 396 /*****************************************************************************
 397  *    IADsContainer interface
 398  */
 399 [
 400     object,
 401     uuid(001677d0-fd16-11ce-abc4-02608c9e7553)
 402 ]
 403 interface IADsContainer: IDispatch
 404 {
 405     [propget] HRESULT Count(
 406         [out, retval] long *retval);
 407     [propget, restricted] HRESULT _NewEnum(
 408         [out, retval] IUnknown **retval);
 409     [propget] HRESULT Filter(
 410         [out, retval] VARIANT *pvFilter);
 411     [propput] HRESULT Filter(
 412         [in] VARIANT vFilter);
 413     [propget] HRESULT Hints(
 414         [out, retval] VARIANT *pvHints);
 415     [propput] HRESULT Hints(
 416         [in] VARIANT vHints);
 417     HRESULT GetObject(
 418         [in] BSTR bstrClassName,
 419         [in] BSTR bstrRelativeName,
 420         [out, retval] IDispatch **ppObject);
 421     HRESULT Create(
 422         [in] BSTR bstrClassName,
 423         [in] BSTR bstrRelativeName,
 424         [out, retval] IDispatch **ppObject);
 425     HRESULT Delete(
 426         [in] BSTR bstrClassName,
 427         [in] BSTR bstrRelativeName);
 428     HRESULT CopyHere(
 429         [in] BSTR bstrSourceName,
 430         [in] BSTR bstrNewName,
 431         [out, retval] IDispatch **ppObject);
 432     HRESULT MoveHere(
 433         [in] BSTR bstrSourceName,
 434         [in] BSTR bstrNewName,
 435         [out, retval] IDispatch **ppObject);
 436 }
 437
 438 /*****************************************************************************
 439  *    IADs interface
 440  */
 441 [
 442     odl,
 443     uuid(FD8256D0-FD15-11CE-ABC4-02608C9E7553),
 444     dual,
 445     oleautomation
 446 ]
 447 interface IADs : IDispatch
 448 {
 449     [id(0x00000002), propget]
 450     HRESULT Name([out, retval] BSTR* retval);
 451
 452     [id(0x00000003), propget]
 453     HRESULT Class([out, retval] BSTR* retval);
 454
 455     [id(0x00000004), propget]
 456     HRESULT GUID([out, retval] BSTR* retval);
 457
 458     [id(0x00000005), propget]
 459     HRESULT ADsPath([out, retval] BSTR* retval);
 460
 461     [id(0x00000006), propget]
 462     HRESULT Parent([out, retval] BSTR* retval);
 463
 464     [id(0x00000007), propget]
 465     HRESULT Schema([out, retval] BSTR* retval);
 466
 467     [id(0x00000008)]
 468     HRESULT GetInfo();
 469
 470     [id(0x00000009)]
 471     HRESULT SetInfo();
 472
 473     [id(0x0000000a)]
 474     HRESULT Get([in] BSTR bstrName, [out, retval] VARIANT* pvProp);
 475
 476     [id(0x0000000b)]
 477     HRESULT Put([in] BSTR bstrName, [in] VARIANT vProp);
 478
 479     [id(0x0000000c)]
 480     HRESULT GetEx([in] BSTR bstrName, [out, retval] VARIANT* pvProp);
 481
 482     [id(0x0000000d)]
 483     HRESULT PutEx([in] long lnControlCode, [in] BSTR bstrName, [in] VARIANT vProp);
 484
 485     [id(0x0000000e)]
 486     HRESULT GetInfoEx( [in] VARIANT vProperties, [in] long lnReserved);
 487 }
 488
 489 /*****************************************************************************
 490  *    IADsMembers interface
 491  */
 492 [
 493     odl,
 494     uuid(451A0030-72EC-11CF-B03B-00AA006E0975),
 495     dual,
 496     oleautomation
 497 ]
 498 interface IADsMembers : IDispatch
 499 {
 500     [id(0x00000002), propget]
 501     HRESULT Count([out, retval] long* plCount);
 502
 503     [id(0xfffffffc), propget]
 504     HRESULT _NewEnum([out, retval] IUnknown** ppEnumerator);
 505
 506     [id(0x00000003), propget]
 507     HRESULT Filter([out, retval] VARIANT* pvFilter);
 508
 509     [id(0x00000003), propput]
 510     HRESULT Filter([in] VARIANT pvFilter);
 511 }
 512
 513 /*****************************************************************************
 514  *    IADsGroup interface
 515  */
 516 [
 517     odl,
 518     uuid(27636B00-410F-11CF-B1FF-02608C9E7553),
 519     dual,
 520     oleautomation
 521 ]
 522 interface IADsGroup : IADs {
 523     [id(0x0000000f), propget]
 524     HRESULT Description([out, retval] BSTR* retval);
 525
 526     [id(0x0000000f), propput]
 527     HRESULT Description([in] BSTR retval);
 528
 529     [id(0x00000010)]
 530     HRESULT Members([out, retval] IADsMembers** ppMembers);
 531
 532     [id(0x00000011)]
 533     HRESULT IsMember([in] BSTR bstrMember, [out, retval] VARIANT_BOOL* bMember);
 534
 535     [id(0x00000012)]
 536     HRESULT Add([in] BSTR bstrNewItem);
 537
 538     [id(0x00000013)]
 539     HRESULT Remove([in] BSTR bstrItemToBeRemoved);
 540 }
 541
 542 /*****************************************************************************
 543  *    IADsUser interface
 544  */
 545 [
 546     odl,
 547     uuid(3E37E320-17E2-11CF-ABC4-02608C9E7553),
 548     dual,
 549     oleautomation
 550 ]
 551 interface IADsUser : IADs
 552 {
 553     [id(0x00000035), propget]
 554     HRESULT BadLoginAddress([out, retval] BSTR* retval);
 555
 556     [id(0x00000036), propget]
 557     HRESULT BadLoginCount([out, retval] long* retval);
 558
 559     [id(0x00000038), propget]
 560     HRESULT LastLogin([out, retval] DATE* retval);
 561
 562     [id(0x00000039), propget]
 563     HRESULT LastLogoff([out, retval] DATE* retval);
 564
 565     [id(0x0000003a), propget]
 566     HRESULT LastFailedLogin([out, retval] DATE* retval);
 567
 568     [id(0x0000003b), propget]
 569     HRESULT PasswordLastChanged([out, retval] DATE* retval);
 570
 571     [id(0x0000000f), propget]
 572     HRESULT Description([out, retval] BSTR* retval);
 573
 574     [id(0x0000000f), propput]
 575     HRESULT Description([in] BSTR retval);
 576
 577     [id(0x00000013), propget]
 578     HRESULT Division([out, retval] BSTR* retval);
 579
 580     [id(0x00000013), propput]
 581     HRESULT Division([in] BSTR retval);
 582
 583     [id(0x0000007a), propget]
 584     HRESULT Department([out, retval] BSTR* retval);
 585
 586     [id(0x0000007a), propput]
 587     HRESULT Department([in] BSTR retval);
 588
 589     [id(0x00000014), propget]
 590     HRESULT EmployeeID([out, retval] BSTR* retval);
 591
 592     [id(0x00000014), propput]
 593     HRESULT EmployeeID([in] BSTR retval);
 594
 595     [id(0x00000017), propget]
 596     HRESULT FullName([out, retval] BSTR* retval);
 597
 598     [id(0x00000017), propput]
 599     HRESULT FullName([in] BSTR retval);
 600
 601     [id(0x00000016), propget]
 602     HRESULT FirstName([out, retval] BSTR* retval);
 603
 604     [id(0x00000016), propput]
 605     HRESULT FirstName([in] BSTR retval);
 606
 607     [id(0x00000019), propget]
 608     HRESULT LastName([out, retval] BSTR* retval);
 609
 610     [id(0x00000019), propput]
 611     HRESULT LastName([in] BSTR retval);
 612
 613     [id(0x0000001b), propget]
 614     HRESULT OtherName([out, retval] BSTR* retval);
 615
 616     [id(0x0000001b), propput]
 617     HRESULT OtherName([in] BSTR retval);
 618
 619     [id(0x00000072), propget]
 620     HRESULT NamePrefix([out, retval] BSTR* retval);
 621
 622     [id(0x00000072), propput]
 623     HRESULT NamePrefix([in] BSTR retval);
 624
 625     [id(0x00000073), propget]
 626     HRESULT NameSuffix([out, retval] BSTR* retval);
 627
 628     [id(0x00000073), propput]
 629     HRESULT NameSuffix([in] BSTR retval);
 630
 631     [id(0x00000024), propget]
 632     HRESULT Title([out, retval] BSTR* retval);
 633
 634     [id(0x00000024), propput]
 635     HRESULT Title([in] BSTR retval);
 636
 637     [id(0x0000001a), propget]
 638     HRESULT Manager([out, retval] BSTR* retval);
 639
 640     [id(0x0000001a), propput]
 641     HRESULT Manager([in] BSTR retval);
 642
 643     [id(0x00000020), propget]
 644     HRESULT TelephoneHome([out, retval] VARIANT* retval);
 645
 646     [id(0x00000020), propput]
 647     HRESULT TelephoneHome([in] VARIANT retval);
 648
 649     [id(0x00000021), propget]
 650     HRESULT TelephoneMobile([out, retval] VARIANT* retval);
 651
 652     [id(0x00000021), propput]
 653     HRESULT TelephoneMobile([in] VARIANT retval);
 654
 655     [id(0x00000022), propget]
 656     HRESULT TelephoneNumber([out, retval] VARIANT* retval);
 657
 658     [id(0x00000022), propput]
 659     HRESULT TelephoneNumber([in] VARIANT retval);
 660
 661     [id(0x00000011), propget]
 662     HRESULT TelephonePager([out, retval] VARIANT* retval);
 663
 664     [id(0x00000011), propput]
 665     HRESULT TelephonePager([in] VARIANT retval);
 666
 667     [id(0x00000010), propget]
 668     HRESULT FaxNumber([out, retval] VARIANT* retval);
 669
 670     [id(0x00000010), propput]
 671     HRESULT FaxNumber([in] VARIANT retval);
 672
 673     [id(0x0000001c), propget]
 674     HRESULT OfficeLocations([out, retval] VARIANT* retval);
 675
 676     [id(0x0000001c), propput]
 677     HRESULT OfficeLocations([in] VARIANT retval);
 678
 679     [id(0x0000001e), propget]
 680     HRESULT PostalAddresses([out, retval] VARIANT* retval);
 681
 682     [id(0x0000001e), propput]
 683     HRESULT PostalAddresses([in] VARIANT retval);
 684
 685     [id(0x0000001f), propget]
 686     HRESULT PostalCodes([out, retval] VARIANT* retval);
 687
 688     [id(0x0000001f), propput]
 689     HRESULT PostalCodes([in] VARIANT retval);
 690
 691     [id(0x00000075), propget]
 692     HRESULT SeeAlso([out, retval] VARIANT* retval);
 693
 694     [id(0x00000075), propput]
 695     HRESULT SeeAlso([in] VARIANT retval);
 696
 697     [id(0x00000025), propget]
 698     HRESULT AccountDisabled([out, retval] VARIANT_BOOL* retval);
 699
 700     [id(0x00000025), propput]
 701     HRESULT AccountDisabled([in] VARIANT_BOOL retval);
 702
 703     [id(0x00000026), propget]
 704     HRESULT AccountExpirationDate([out, retval] DATE* retval);
 705
 706     [id(0x00000026), propput]
 707     HRESULT AccountExpirationDate([in] DATE retval);
 708
 709     [id(0x00000029), propget]
 710     HRESULT GraceLoginsAllowed([out, retval] long* retval);
 711
 712     [id(0x00000029), propput]
 713     HRESULT GraceLoginsAllowed([in] long retval);
 714
 715     [id(0x0000002a), propget]
 716     HRESULT GraceLoginsRemaining([out, retval] long* retval);
 717
 718     [id(0x0000002a), propput]
 719     HRESULT GraceLoginsRemaining([in] long retval);
 720
 721     [id(0x0000002b), propget]
 722     HRESULT IsAccountLocked([out, retval] VARIANT_BOOL* retval);
 723
 724     [id(0x0000002b), propput]
 725     HRESULT IsAccountLocked([in] VARIANT_BOOL retval);
 726
 727     [id(0x0000002d), propget]
 728     HRESULT LoginHours([out, retval] VARIANT* retval);
 729
 730     [id(0x0000002d), propput]
 731     HRESULT LoginHours([in] VARIANT retval);
 732
 733     [id(0x0000002e), propget]
 734     HRESULT LoginWorkstations([out, retval] VARIANT* retval);
 735
 736     [id(0x0000002e), propput]
 737     HRESULT LoginWorkstations([in] VARIANT retval);
 738
 739     [id(0x0000002f), propget]
 740     HRESULT MaxLogins([out, retval] long* retval);
 741
 742     [id(0x0000002f), propput]
 743     HRESULT MaxLogins([in] long retval);
 744
 745     [id(0x00000030), propget]
 746     HRESULT MaxStorage([out, retval] long* retval);
 747
 748     [id(0x00000030), propput]
 749     HRESULT MaxStorage([in] long retval);
 750
 751     [id(0x00000031), propget]
 752     HRESULT PasswordExpirationDate([out, retval] DATE* retval);
 753
 754     [id(0x00000031), propput]
 755     HRESULT PasswordExpirationDate([in] DATE retval);
 756
 757     [id(0x00000032), propget]
 758     HRESULT PasswordMinimumLength([out, retval] long* retval);
 759
 760     [id(0x00000032), propput]
 761     HRESULT PasswordMinimumLength([in] long retval);
 762
 763     [id(0x00000033), propget]
 764     HRESULT PasswordRequired([out, retval] VARIANT_BOOL* retval);
 765
 766     [id(0x00000033), propput]
 767     HRESULT PasswordRequired([in] VARIANT_BOOL retval);
 768
 769     [id(0x00000034), propget]
 770     HRESULT RequireUniquePassword([out, retval] VARIANT_BOOL* retval);
 771
 772     [id(0x00000034), propput]
 773     HRESULT RequireUniquePassword([in] VARIANT_BOOL retval);
 774
 775     [id(0x0000003c), propget]
 776     HRESULT EmailAddress([out, retval] BSTR* retval);
 777
 778     [id(0x0000003c), propput]
 779     HRESULT EmailAddress([in] BSTR retval);
 780
 781     [id(0x0000003d), propget]
 782     HRESULT HomeDirectory([out, retval] BSTR* retval);
 783
 784     [id(0x0000003d), propput]
 785     HRESULT HomeDirectory([in] BSTR retval);
 786
 787     [id(0x0000003e), propget]
 788     HRESULT Languages([out, retval] VARIANT* retval);
 789
 790     [id(0x0000003e), propput]
 791     HRESULT Languages([in] VARIANT retval);
 792
 793     [id(0x0000003f), propget]
 794     HRESULT Profile([out, retval] BSTR* retval);
 795
 796     [id(0x0000003f), propput]
 797     HRESULT Profile([in] BSTR retval);
 798
 799     [id(0x00000040), propget]
 800     HRESULT LoginScript([out, retval] BSTR* retval);
 801
 802     [id(0x00000040), propput]
 803     HRESULT LoginScript([in] BSTR retval);
 804
 805     [id(0x00000041), propget]
 806     HRESULT Picture([out, retval] VARIANT* retval);
 807
 808     [id(0x00000041), propput]
 809     HRESULT Picture([in] VARIANT retval);
 810
 811     [id(0x00000078), propget]
 812     HRESULT HomePage([out, retval] BSTR* retval);
 813
 814     [id(0x00000078), propput]
 815     HRESULT HomePage([in] BSTR retval);
 816
 817     [id(0x00000042)]
 818     HRESULT Groups([out, retval] IADsMembers** ppGroups);
 819
 820     [id(0x00000043)]
 821     HRESULT SetPassword([in] BSTR NewPassword);
 822
 823     [id(0x00000044)]
 824     HRESULT ChangePassword([in] BSTR bstrOldPassword, [in] BSTR bstrNewPassword);
 825 }
 826
 827 /*****************************************************************************
 828  *    IDirectorySearch interface
 829  */
 830 [
 831     odl,
 832     local,
 833     uuid(109BA8EC-92F0-11D0-A790-00C04FD8D5A8)
 834 ]
 835 interface IDirectorySearch : IUnknown
 836 {
 837     HRESULT SetSearchPreference([in] PADS_SEARCHPREF_INFO pSearchPrefs, [in] DWORD dwNumPrefs);
 838     HRESULT ExecuteSearch([in] LPWSTR pszSearchFilter, [in] LPWSTR* pAttributeNames,
 839                     [in] DWORD dwNumberAttributes, [out] PADS_SEARCH_HANDLE phSearchResult);
 840     HRESULT AbandonSearch([in] ADS_SEARCH_HANDLE phSearchResult);
 841     HRESULT GetFirstRow([in] ADS_SEARCH_HANDLE hSearchResult);
 842     HRESULT GetNextRow([in] ADS_SEARCH_HANDLE hSearchResult);
 843     HRESULT GetPreviousRow([in] ADS_SEARCH_HANDLE hSearchResult);
 844     HRESULT GetNextColumnName([in] ADS_SEARCH_HANDLE hSearchHandle, [out] LPWSTR* ppszColumnName);
 845     HRESULT GetColumn( [in] ADS_SEARCH_HANDLE hSearchResult, [in] LPWSTR szColumnName,
 846                     [out] PADS_SEARCH_COLUMN pSearchColumn);
 847     HRESULT FreeColumn([in] PADS_SEARCH_COLUMN pSearchColumn);
 848     HRESULT CloseSearchHandle([in] ADS_SEARCH_HANDLE hSearchResult);
 849 }
 850
 851 /*****************************************************************************
 852  *    IDirectoryObject interface
 853  */
 854 [
 855     odl,
 856     local,
 857     uuid(e798de2c-22e4-11d0-84fe-00c04fd8d503)
 858 ]
 859 interface IDirectoryObject : IUnknown
 860 {
 861     HRESULT GetObjectInformation(PADS_OBJECT_INFO *info);
 862     HRESULT GetObjectAttributes(LPWSTR *names, DWORD count, PADS_ATTR_INFO *attrs, DWORD *count_returned);
 863     HRESULT SetObjectAttributes(PADS_ATTR_INFO attrs, DWORD count, DWORD *count_set);
 864     HRESULT CreateDSObject(LPWSTR name, PADS_ATTR_INFO attrs, DWORD count, IDispatch **obj);
 865     HRESULT DeleteDSObject(LPWSTR name);
 866 }
 867
 868 /*****************************************************************************
 869  *    IID_IADsOpenDSObject interface
 870  */
 871 [
 872     odl,
 873     uuid(ddf2891e-0f9c-11d0-8ad4-00c04fd8d503),
 874     dual,
 875     oleautomation
 876 ]
 877 interface IADsOpenDSObject : IDispatch
 878 {
 879     HRESULT OpenDSObject([in] BSTR path, [in] BSTR user, [in] BSTR password, [in] long reserved, [out,retval] IDispatch **obj);
 880 }
 881
 882 /*****************************************************************************
 883  *   IADsPathname interface
 884  */
 885 [
 886     odl,
 887     uuid(d592aed4-f420-11d0-a36e-00c04fb950dc),
 888     dual,
 889     oleautomation
 890 ]
 891 interface IADsPathname : IDispatch
 892 {
 893     HRESULT Set(BSTR path, long type);
 894     HRESULT SetDisplayType(long type);
 895     HRESULT Retrieve(long type, BSTR *path);
 896     HRESULT GetNumElements(long *count);
 897     HRESULT GetElement(long index, BSTR *element);
 898     HRESULT AddLeafElement(BSTR element);
 899     HRESULT RemoveLeafElement(void);
 900     HRESULT CopyPath(IDispatch **path);
 901     HRESULT GetEscapedElement(long reserved, BSTR element, BSTR *str);
 902     HRESULT get_EscapedMode(long *mode);
 903     HRESULT put_EscapedMode(long mode);
 904 }
 905
 906 /*****************************************************************************
 907  *    IADsADSystemInfo interface
 908  */
 909 [
 910     odl,
 911     uuid(5bb11929-afd1-11d2-9cb9-0000f87a369e),
 912     dual,
 913     oleautomation
 914 ]
 915 interface IADsADSystemInfo : IDispatch
 916 {
 917     [id(0x00000002), propget]
 918     HRESULT UserName([out, retval] BSTR *retval);
 919     [id(0x00000003), propget]
 920     HRESULT ComputerName([out, retval] BSTR *retval);
 921     [id(0x00000004), propget]
 922     HRESULT SiteName([out, retval] BSTR *retval);
 923     [id(0x00000005), propget]
 924     HRESULT DomainShortName([out, retval] BSTR *retval);
 925     [id(0x00000006), propget]
 926     HRESULT DomainDNSName([out, retval] BSTR *retval);
 927     [id(0x00000007), propget]
 928     HRESULT ForestDNSName([out, retval] BSTR *retval);
 929     [id(0x00000008), propget]
 930     HRESULT PDCRoleOwner([out, retval] BSTR *retval);
 931     [id(0x00000009), propget]
 932     HRESULT SchemaRoleOwner([out, retval] BSTR *retval);
 933     [id(0x0000000a), propget]
 934     HRESULT IsNativeMode([out, retval] VARIANT_BOOL *retval);
 935     [id(0x0000000b)]
 936     HRESULT GetAnyDCName([out, retval] BSTR *retval);
 937     [id(0x0000000c)]
 938     HRESULT GetDCSiteName([in] BSTR server, [out, retval] BSTR *retval);
 939     [id(0x0000000d)]
 940     HRESULT RefreshSchemaCache();
 941     [id(0x0000000e)]
 942     HRESULT GetTrees([out, retval] VARIANT *retval);
 943 }
 944
 945 [
 946     helpstring("AD System Info Object"),
 947     uuid(50b6327f-afd1-11d2-9cb9-0000f87a369e),
 948     progid("ADSystemInfo"),
 949     version(1.0)
 950 ]
 951 coclass ADSystemInfo
 952 {
 953     interface IADsADSystemInfo;
 954 }
 955
 956 } /* library */