Win32 API 日本語リファレンス
ホーム › Networking.ActiveDirectory › IADsPropertyValue2

IADsPropertyValue2

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID306e831c-5bc7-11d1-a3b8-00c04fb950dc継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IADsPropertyEntry オブジェクトの値を任意のデータ形式で表現するために使用します。

解説(Remarks)

次の表は、 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_ARRAY | VT_UI4
ADSTYPE_UTC_TIME VT_DATE
ADSTYPE_LARGE_INTEGER VT_DISPATCH (IADsLargeInteger)
ADSTYPE_PROV_SPECIFIC VT_ARRAY | VT_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)

メソッド 2

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT GetObjectProperty(INT* lnADsType, VARIANT* pvProp)

属性値を取得します。

lnADsTypeINT*inout

呼び出し時に、値を返すデータ形式を指定する ADSTYPEENUM 値のいずれかを格納する変数へのポインター。

データ型が不明な場合は、これを ADSTYPE_UNKNOWN に設定します。この場合、このメソッドは既定のデータ型で属性値を取得し、この変数に対応する ADSTYPEENUM 値を設定します。それ以外の ADSTYPEENUM 値を指定した場合、ADSI はデータ型が値の形式と一致する場合にのみ属性値を返します。

pvPropVARIANT*out要求した属性値を受け取る VARIANT へのポインター。このデータの variant 型は、lnADsType で返される値によって異なります。詳細、および lnADsType の値と対応する pvProp の variant 型の一覧については、IADsPropertyValue2 を参照してください。

戻り値

成功した場合は S_OK を、それ以外の場合は次のいずれかのエラーコードを返します。

vtbl 8 HRESULT PutObjectProperty(INT lnADsType, VARIANT vProp)

属性値を設定します。

lnADsTypeINTin設定する値のデータ形式を指定する ADSTYPEENUM 値のいずれかを格納します。この値は pvProp の variant 型に対応している必要があります。詳細、および lnADsType の値と対応する pvProp の variant 型の一覧については、IADsPropertyValue2 を参照してください。
vPropVARIANTin新しい属性値を格納する VARIANT へのポインター。このデータの variant 型は、lnADsType の値に対応している必要があります。詳細、および lnADsType の値と対応する pvProp の variant 型の一覧については、IADsPropertyValue2 を参照してください。

戻り値

成功した場合は S_OK を、それ以外の場合はエラーコードを返します。次に最も一般的なエラーコードを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IADsPropertyValue2 "{306E831C-5BC7-11D1-A3B8-00C04FB950DC}"
#usecom global IADsPropertyValue2 IID_IADsPropertyValue2 "{}"
#comfunc global IADsPropertyValue2_GetObjectProperty  7 var,var
#comfunc global IADsPropertyValue2_PutObjectProperty  8 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。