LsaSetTrustedDomainInformation 函数 (ntsecapi.h)
LsaSetTrustedDomainInformation 函数修改 Policy 对象有关受信任域的信息。
语法
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 |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |