DsRoleGetPrimaryDomainInformation 関数 (dsrole.h)

DsRoleGetPrimaryDomainInformation 関数は、コンピューターの状態データを取得します。 このデータには、ディレクトリ サービスのインストールとドメイン データの状態が含まれます。

構文

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

パラメーター

[in] lpServer

関数を呼び出すコンピューターの名前を含む null で終わる Unicode 文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。

[in] InfoLevel

取得するデータの種類を指定する DSROLE_PRIMARY_DOMAIN_INFO_LEVEL 値のいずれかを格納します。 このパラメーターは、Buffer で提供されるデータの形式も決定 します。

[out] Buffer

要求されたデータを受信するバッファーのアドレスへのポインター。 このデータの形式は 、InfoLevel パラメーターの値によって異なります。

DsRoleFreeMemory を呼び出して不要になった場合、呼び出し元はこのメモリを解放する必要があります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値には次のいずれかの値を指定できます。

要件

こちらもご覧ください

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

ディレクトリ サービス関数

DsRoleFreeMemory