LsaSetTrustedDomainInformation 函式 (ntsecapi.h)
LsaSetTrustedDomainInformation 函式會修改原則對象有關受信任網域的資訊。
語法
NTSTATUS LsaSetTrustedDomainInformation(
[in] LSA_HANDLE PolicyHandle,
[in] PSID TrustedDomainSid,
[in] TRUSTED_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
參數
[in] PolicyHandle
域控制器之 Policy 物件的句柄。 此句柄的必要用戶權力取決於 InformationClass 參數的值。 如需詳細資訊，請參閱 開啟原則物件句柄。
[in] TrustedDomainSid
信任網域之 SID 的指標，其資訊已修改。 如果 InformationClass 參數設定為 TrustedDomainNameInformation，此參數必須指向網域的 SID，才能新增至信任網域清單。
[in] InformationClass
從 TRUSTED_INFORMATION_CLASS 列舉型別指定下列其中一個值。 值表示所設定的信息類型。
| 值 | 意義 |
|---|---|
|
如果指定的網域不在信任網域清單中， LsaSetTrustedDomainInformation 函式 會新增它。
TrustedDomainSid 參數必須是要新增之網域的 SID。
Buffer 參數必須是TRUSTED_DOMAIN_NAME_INFO結構的指標，其中包含要加入的網域名稱。
如果指定的網域已經在受信任網域清單中，則函式會失敗。 |
|
設定用來產生Posix使用者和群組標識碼的值。 Buffer 參數必須是TRUSTED_POSIX_OFFSET_INFO結構的指標。 |
|
設定受信任網域的密碼。 Buffer 參數必須是TRUSTED_PASSWORD_INFO結構的指標，其中包含指定網域的舊密碼和新密碼。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_CREATE_SECRET訪問許可權。 舊的密碼字串可以是 NULL。 |
[in] Buffer
結構的指標，其中包含要設定的資訊。 結構的型別取決於 InformationClass 參數的值。
傳回值
如果函式成功，傳回值會STATUS_SUCCESS。
如果函式失敗，傳回值為NTSTATUS程式碼。 如需詳細資訊，請參閱 LSA 原則函式傳回值。
您可以使用 LsaNtStatusToWinError 函 式，將 NTSTATUS 程式代碼轉換成 Windows 錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ntsecapi.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |