dsListRolesA 函式 (ntdsapi.h)
DsListRoles 函式會列出伺服器所辨識的角色。
語法
NTDSAPI DWORD DsListRolesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppRoles
);
參數
[in] hDs
包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。
[out] ppRoles
接收伺服器所辨識之 角色之DS_NAME_RESULT 結構的指標之變數指標。 傳回的結構必須使用 DsFreeNameResult 解除分配。
DS_NAME_RESULT 結構中陣列的索引會指出每個數位元素包含哪些數據。 下列常數可用來指定特定數據片段所需的索引。
DS_ROLE_DOMAIN_OWNER
伺服器擁有網域。
DS_ROLE_INFRASTRUCTURE_OWNER
伺服器擁有基礎結構。
DS_ROLE_PDC_OWNER
伺服器擁有 PDC。
DS_ROLE_RID_OWNER
伺服器擁有 RID。
DS_ROLE_SCHEMA_OWNER
伺服器擁有架構。
傳回值
如果函式傳回角色清單,則會 NO_ERROR傳回值。
如果函式失敗,傳回值可以是下列其中一個錯誤碼。
傳回 DS_NAME_RESULT 結構中會報告個別名稱轉換錯誤。
備註
注意
ntdsapi.h 標頭會將 DsListRoles 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | ntdsapi.h |
程式庫 | Ntdsapi.lib |
Dll | Ntdsapi.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應