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 |