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 枚举类型中的下列值之一。 值指示要设置的信息的类型。

值 含义
TrustedDomainNameInformation
 如果指定的域不在受信任域列表中， 则 LsaSetTrustedDomainInformation 函数会添加该域。 TrustedDomainSid 参数必须是要添加的域的 SID。 Buffer 参数必须是指向包含要添加的域名称的TRUSTED_DOMAIN_NAME_INFO结构的指针。

如果指定的域已在受信任域列表中，则函数将失败。
TrustedPosixOffsetInformation
 设置用于生成 Posix 用户和组标识符的值。 Buffer 参数必须是指向 TRUSTED_POSIX_OFFSET_INFO 结构的指针。
TrustedPasswordInformation
 设置受信任域的密码。 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

另请参阅

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO