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 |
| 目標平臺 | 窗戶 |
| 標頭 | ntdsapi.h |
| 連結庫 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |