다음을 통해 공유


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

ADSI 단순 데이터 형식ADS_DN_STRING 정의된 디렉터리 서비스 개체의 고유 이름(경로)을 식별하는 null로 끝나는 유니코드 문자열입니다.

CaseExactString

ADSI 단순 데이터 형식ADS_CASE_EXACT_STRING 정의한 대로 대/소문자를 구분하여 해석할 null로 끝나는 유니코드 문자열입니다.

CaseIgnoreString

ADSI 단순 데이터 형식ADS_CASE_IGNORE_STRING 정의한 대로 대/소문자 없이 해석할 null로 끝나는 유니코드 문자열입니다.

PrintableString

ADSI 단순 데이터 형식ADS_PRINTABLE_STRING 정의한 대로 표시하거나 인쇄할 수 있는 null로 끝나는 유니코드 문자열입니다.

NumericString

ADSI 단순 데이터 형식ADS_NUMERIC_STRING 정의한 대로 텍스트로 해석할 숫자가 포함된 null로 끝나는 유니코드 문자열입니다.

Boolean

ADS_BOOLEAN 정의한 부울 값은 ADSI 단순 데이터 형식입니다.

Integer

ADS_INTEGER 정의한 정수 값은 ADSI 단순 데이터 형식입니다.

OctetString

ADSI 정의 데이터 형식인 ADS_OCTET_STRING 정의한 8진수 문자열입니다.

UTCTime

ADSI 단순 데이터 형식ADS_UTC_TIME 정의한 UTC(협정 세계시)로 지정된 시간입니다.

LargeInteger

ADS_LARGE_INTEGER 정의한 긴 정수 값은 ADSI 단순 데이터 형식입니다.

ClassName

ADS_OBJECT_CLASS 정의한 클래스 이름 문자열은 ADSI 단순 데이터 형식입니다.

ProviderSpecific

ADS_PROV_SPECIFIC 정의된 공급자별 구조체로, ADSI 정의 데이터 형식입니다.

pCaseIgnoreList

ADSI 정의 데이터 형식인 ADS_CASEIGNORE_LIST 대한 포인터입니다.

pOctetList

ADSI 정의 데이터 형식인 ADS_OCTET_LIST 목록에 대한 포인터입니다.

pPath

ADSI 정의 데이터 형식인 ADS_PATH 이름에 대한 포인터입니다.

pPostalAddress

ADSI 정의 데이터 형식인 ADS_POSTALADDRESS 데이터에 대한 포인터입니다.

Timestamp

ADSI 정의 데이터 형식인 ADS_TIMESTAMP 형식의 타임스탬프를 지정합니다.

BackLink

ADSI 정의 데이터 형식인 ADS_BACKLINK 형식의 링크입니다.

pTypedName

ADSI 정의 데이터 형식인 ADS_TYPEDNAME 이름에 대한 포인터입니다.

Hold

ADS_HOLD 형식의 데이터 구조, ADSI 정의 데이터 형식입니다.

pNetAddress

ADSI 정의 데이터 형식인 ADS_NETADDRESS 데이터에 대한 포인터입니다.

pReplicaPointer

ADSI 정의 데이터 형식인 ADS_REPLICAPOINTER 복제본(replica) 포인터에 대한 포인터입니다.

pFaxNumber

ADSI 정의 데이터 형식인 ADS_FAXNUMBER 팩시밀 수에 대한 포인터입니다.

Email

ADSI 정의 데이터 형식인 ADS_EMAIL 사용자의 Email 주소입니다.

SecurityDescriptor

ADSI 정의 데이터 형식인 ADS_NT_SECURITY_DESCRIPTOR 정의한 Windows 보안 설명자입니다.

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