IDirectoryObject::GetObjectInformation メソッド (iads.h)
IDirectoryObject::GetObjectInformation メソッドは、ディレクトリ サービス オブジェクトの ID と場所に関するデータを含むADS_OBJECT_INFO構造体へのポインターを取得します。
構文
HRESULT GetObjectInformation(
[out] PADS_OBJECT_INFO *ppObjInfo
);
パラメーター
[out] ppObjInfo
要求されたディレクトリ サービス オブジェクトに関するデータを含む ADS_OBJECT_INFO 構造体へのポインターのアドレスを提供します。 戻り時に ppObjInfo が NULL の 場合、 GetObjectInformation は要求されたデータを取得できません。
戻り値
このメソッドは、データが正常に取得 されたときにS_OK を含む標準の戻り値を返します。 詳細およびその他の戻り値については、「 ADSI エラー コード」を参照してください。
注釈
呼び出し元は FreeADsMem ヘルパー関数を呼び出して、GetObjectInformation 関数によって作成されたADS_OBJECT_INFO構造体を解放する必要があります。
オートメーション クライアントは 、IADs::GetInfo を呼び出す必要があります。
例
次の C++ コード例は、IDirectoryObject インターフェイスを実装するオブジェクト (m_pDirObject) の GetObjectInformation メソッドを使用して、オブジェクト データ (ADS_OBJECT_INFO) を取得する方法を示しています。
ADS_OBJECT_INFO *pInfo;
HRESULT hr;
hr = m_pDirObject->GetObjectInformation(&pInfo);
if (!SUCCEEDED(hr) )
{
return;
}
//////////////////////////
// Show the attributes
/////////////////////////
printf("RDN: %S\n", pInfo->pszRDN);
printf("ObjectDN: %S\n", pInfo->pszObjectDN);
printf("Parent DN: %S\n", pInfo->pszParentDN);
printf("Class Name: %S\n", pInfo->pszClassName);
printf("Schema DN: %S\n", pInfo->pszSchemaDN);
///////////////////////////////////////////////////////////
// Remember to clean up the memory using FreeADsMem.
//////////////////////////////////////////////////////////
FreeADsMem( pInfo );
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | iads.h |
| [DLL] | Activeds.dll |