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。

如果函式失敗，傳回值可以是下列其中一個值。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 dsrole.h
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

目錄服務函式

DsRoleFreeMemory