IDirectoryObject::GetObjectInformation メソッド (iads.h)

[アーティクル]
02/28/2024

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