IADsPropertyValue2 インターフェイス (iads.h)
IADsPropertyValue2 インターフェイスは、新規データ型や顧客定義データ型を含む任意のデータ形式で IADsPropertyEntry オブジェクトの値を表すために使用されます。 このインターフェイスは、複数のディレクトリ サービスの属性値を処理する場合にも役立ちます。
IADsPropertyEntry.Values プロパティには、IADsPropertyValue2 オブジェクトの配列が含まれています。 各 IADsPropertyValue オブジェクトには、IADsPropertyEntry オブジェクトの 1 つの値が含まれています。 完全に新しいプロパティ エントリと値を作成するための詳細とコード例については、「 IADsPropertyList.PutPropertyItem」を参照してください。
このインターフェイスのメソッドを呼び出す前に、キャッシュが初期化されていない場合は、 IADs.GetInfo または IADs.GetInfoEx を明示的に呼び出して、オブジェクトの割り当てられた値をキャッシュに読み込む必要があります。 オブジェクトの値を変更した後、 IADs.SetInfo を呼び出して、基になるディレクトリの永続ストアに変更を保存する必要があります。
このインターフェイスは、任意のデータ型を取得するために使用できるため、 IADsPropertyValue よりも汎用性が高くなります。 IADsPropertyValue インターフェイスは、限られた数のデータ型を取得するためにのみ使用できます。
継承
IADsPropertyValue2 インターフェイスは、IDispatch インターフェイスから継承されます。 IADsPropertyValue2 には、次の種類のメンバーもあります。
メソッド
IADsPropertyValue2 インターフェイスには、これらのメソッドがあります。
| IADsPropertyValue2::GetObjectProperty 属性値を取得します。 |
| IADsPropertyValue2::P utObjectProperty 属性値を設定します。 |
注釈
次の表に、GetObjectProperty メソッドと PutObjectProperty メソッドの lnADsType パラメーター値を、対応する pvProp データ型に示します。
| lnADsType 値 | pvProp データ型 |
|---|---|
| ADSTYPE_INVALID | 使用できません。 |
| ADSTYPE_DN_STRING | VT_BSTR |
| ADSTYPE_CASE_EXACT_STRING | VT_BSTR |
| ADSTYPE_CASE_IGNORE_STRING | VT_BSTR |
| ADSTYPE_PRINTABLE_STRING | VT_BSTR |
| ADSTYPE_NUMERIC_STRING | VT_BSTR |
| ADSTYPE_BOOLEAN | VT_BOOL |
| ADSTYPE_INTEGER | VT_I4 |
| ADSTYPE_OCTET_STRING | | VT_ARRAYVT_UI4 |
| ADSTYPE_UTC_TIME | VT_DATE |
| ADSTYPE_LARGE_INTEGER | VT_DISPATCH (IADsLargeInteger) |
| ADSTYPE_PROV_SPECIFIC | | VT_ARRAYVT_UI1 |
| ADSTYPE_OBJECT_CLASS | 使用できません。 |
| ADSTYPE_CASEIGNORE_LIST | VT_DISPATCH (IADsCaseIgnoreList) |
| ADSTYPE_OCTET_LIST | VT_DISPATCH (IADsOctetList) |
| ADSTYPE_PATH | VT_DISPATCH (IADsPath) |
| ADSTYPE_POSTALADDRESS | VT_DISPATCH (IADsPostalAddress) |
| ADSTYPE_TIMESTAMP | VT_DISPATCH (IADsTimestamp) |
| ADSTYPE_BACKLINK | VT_DISPATCH (IADsBackLink) |
| ADSTYPE_TYPEDNAME | VT_DISPATCH (IADsTypedName) |
| ADSTYPE_HOLD | VT_DISPATCH (IADsHold) |
| ADSTYPE_NETADDRESS | VT_DISPATCH (IADsNetAddress) |
| ADSTYPE_REPLICAPOINTER | VT_DISPATCH (IADsReplicaPointer) |
| ADSTYPE_FAXNUMBER | VT_DISPATCH (IADsFaxNumber) |
| ADSTYPE_EMAIL | VT_DISPATCH (IADsEmail) |
| ADSTYPE_NT_SECURITY_DESCRIPTOR | VT_DISPATCH (IADsSecurityDescriptor) |
| ADSTYPE_UNKNOWN | 使用できません。 |
| ADSTYPE_DN_WITH_BINARY | VT_DISPATCH (IADsDNWithBinary) |
| ADSTYPE_DN_WITH_STRING | VT_DISPATCH (IADsDNWithString) |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | iads.h |