ADSVALUE 結構 (iads.h)

ADSVALUE結構包含指定為 ADSI 資料類型的值。 這些資料類型可以是 ADSI 單一資料型別 ,或包含 C 樣式結構的 ADSI 定義自訂資料類型。

ADS_ATTR_INFO結構包含ADSVALUE結構的陣列。 每個 ADSVALUE 結構都包含單一屬性值。

語法

typedef struct _adsvalue {
  ADSTYPE dwType;
  union {
    ADS_DN_STRING              DNString;
    ADS_CASE_EXACT_STRING      CaseExactString;
    ADS_CASE_IGNORE_STRING     CaseIgnoreString;
    ADS_PRINTABLE_STRING       PrintableString;
    ADS_NUMERIC_STRING         NumericString;
    ADS_BOOLEAN                Boolean;
    ADS_INTEGER                Integer;
    ADS_OCTET_STRING           OctetString;
    ADS_UTC_TIME               UTCTime;
    ADS_LARGE_INTEGER          LargeInteger;
    ADS_OBJECT_CLASS           ClassName;
    ADS_PROV_SPECIFIC          ProviderSpecific;
    PADS_CASEIGNORE_LIST       pCaseIgnoreList;
    PADS_OCTET_LIST            pOctetList;
    PADS_PATH                  pPath;
    PADS_POSTALADDRESS         pPostalAddress;
    ADS_TIMESTAMP              Timestamp;
    ADS_BACKLINK               BackLink;
    PADS_TYPEDNAME             pTypedName;
    ADS_HOLD                   Hold;
    PADS_NETADDRESS            pNetAddress;
    PADS_REPLICAPOINTER        pReplicaPointer;
    PADS_FAXNUMBER             pFaxNumber;
    ADS_EMAIL                  Email;
    ADS_NT_SECURITY_DESCRIPTOR SecurityDescriptor;
    PADS_DN_WITH_BINARY        pDNWithBinary;
    PADS_DN_WITH_STRING        pDNWithString;
  };
} ADSVALUE, *PADSVALUE, *LPADSVALUE;

成員

dwType

用來解譯 結構的聯集成員的資料類型。 這個成員的值取自 ADSTYPEENUM 列舉。

DNString

以 null 結尾的 Unicode 字串,可識別目錄服務物件的辨別名稱 (路徑) ,如ADSI 單一資料型別ADS_DN_STRING所定義。

CaseExactString

要區分大小寫的 Null 終止 Unicode 字串,如ADSI 單一資料型別ADS_CASE_EXACT_STRING所定義。

CaseIgnoreString

不論大小寫為何,要解譯的 Null 終止 Unicode 字串,如ADSI 單一資料型別ADS_CASE_IGNORE_STRING所定義。

PrintableString

可以顯示或列印的 Null 終止 Unicode 字串,如ADSI 單一資料型別ADS_PRINTABLE_STRING所定義。

NumericString

Null 終止的 Unicode 字串,其中包含要解譯為文字的數位,如ADSI 單一資料型別ADS_NUMERIC_STRING所定義。

Boolean

布林值,如 ADS_BOOLEAN所定義, ADSI 單一資料型別

Integer

ADSI 單一資料型別ADS_INTEGER所定義的整數值。

OctetString

ADS_OCTET_STRING定義的 ADSI 定義資料類型所定義的八位字串。

UTCTime

指定為國際標準時間 (UTC) 的時間,如ADSI 單一資料型別ADS_UTC_TIME所定義。

LargeInteger

ADSI 單一資料型別ADS_LARGE_INTEGER定義的長整數值。

ClassName

類別名稱字串,如 ADS_OBJECT_CLASS所定義, 是 ADSI 單一資料型別

ProviderSpecific

提供者特定結構,如 ADS_PROV_SPECIFIC定義之 ADSI 定義的資料類型所定義。

pCaseIgnoreList

ADS_CASEIGNORE_LIST的指標,即 ADSI 定義的資料類型。

pOctetList

ADS_OCTET_LIST清單的指標,這是 ADSI 定義的資料類型。

pPath

ADS_PATH名稱的指標,即 ADSI 定義的資料類型。

pPostalAddress

ADS_POSTALADDRESS資料的指標,這是 ADSI 定義的資料類型。

Timestamp

ADS_TIMESTAMP類型的時間戳記,這是 ADSI 定義的資料類型。

BackLink

ADS_BACKLINK類型的連結,即 ADSI 定義的資料類型。

pTypedName

ADS_TYPEDNAME名稱的指標,這是 ADSI 定義的資料類型。

Hold

ADS_HOLD型別的資料結構,即 ADSI 定義的資料類型。

pNetAddress

ADS_NETADDRESS資料的指標,即 ADSI 定義的資料類型。

pReplicaPointer

ADS_REPLICAPOINTER複本指標的指標,這是 ADSI 定義的資料類型。

pFaxNumber

facsimile 數目 ADS_FAXNUMBER的指標,這是 ADSI 定義的資料類型。

Email

Email ADS_EMAIL使用者位址,即 ADSI 定義的資料類型。

SecurityDescriptor

Windows 安全性描述項,如 ADS_NT_SECURITY_DESCRIPTOR所定義,是 ADSI 定義的資料類型。

pDNWithBinary

將物件辨別名稱對應至其 GUID 值的 ADS_DN_WITH_BINARY 結構的指標。

pDNWithString

將物件辨別名稱對應至非靜態字串值的 ADS_DN_WITH_STRING 結構的指標。

備註

ADSVALUE結構的成員會指定屬性的資料類型。 如需詳細資訊和程式碼範例,請參閱 ADS_ATTR_INFO

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 iads.h

另請參閱

ADSI 單一資料型別

ADSI 結構

ADSTYPEENUM

ADS_ATTR_INFO

ADS_BACKLINK

ADS_CASEIGNORE_LIST

ADS_DN_WITH_BINARY

ADS_DN_WITH_STRING

ADS_EMAIL

ADS_FAXNUMBER

ADS_HOLD

ADS_NETADDRESS

ADS_NT_SECURITY_DESCRIPTOR

ADS_OCTET_LIST

ADS_OCTET_STRING

ADS_PATH

ADS_POSTALADDRESS

ADS_PROV_SPECIFIC

ADS_REPLICAPOINTER

ADS_TIMESTAMP

ADS_TYPEDNAME

IDirectoryObject::CreateDSObject

IDirectoryObject::GetObjectAttributes

IDirectoryObject::SetObjectAttributes

IDirectorySearch::SetSearchPreference