LsaCreateTrustedDomainEx 函数 (ntsecapi.h)

项目
03/05/2024

LsaCreateTrustedDomainEx 函数通过创建新的 TrustedDomain 对象来建立新的受信任域。

语法

NTSTATUS LsaCreateTrustedDomainEx(
  [in]  LSA_HANDLE                       PolicyHandle,
  [in]  PTRUSTED_DOMAIN_INFORMATION_EX   TrustedDomainInformation,
  [in]  PTRUSTED_DOMAIN_AUTH_INFORMATION AuthenticationInformation,
  [in]  ACCESS_MASK                      DesiredAccess,
  [out] PLSA_HANDLE                      TrustedDomainHandle
);

参数

[in] PolicyHandle

Policy 对象的句柄。要创建对象，调用方必须有权在系统容器上创建子级。有关策略对象句柄的信息，请参阅打开策略对象句柄。

[in] TrustedDomainInformation

指向包含新受信任域的名称和 SID 的 TRUSTED_DOMAIN_INFORMATION_EX 结构的指针。

[in] AuthenticationInformation

指向包含新受信任域的身份验证信息的 TRUSTED_DOMAIN_AUTH_INFORMATION 结构的指针。

[in] DesiredAccess

一个ACCESS_MASK结构，指定要为新的受信任域授予的访问权限。

[out] TrustedDomainHandle

接收远程受信任域的 LSA 策略句柄。可以将此句柄传递到 LSA 函数调用中，以管理受信任域的 LSA 策略。

当应用程序不再需要此句柄时，它应调用 LsaClose 以删除该句柄。

返回值

如果函数成功，该函数将返回STATUS_SUCCESS。

如果函数失败，它将返回 NTSTATUS 代码，该代码可以是下列值之一或 LSA 策略函数返回值之一。

返回代码	说明
STATUS_DIRECTORY_SERVICE_REQUIRED	在 TrustedDomain 对象) TrustedDomainInformation 参数中指定的目标系统 (不是域控制器。
STATUS_INVALID_SID	指定的 SID 无效。
STATUS_UNSUCCESSFUL	无法确定目标系统是否为域控制器。

可以使用 LsaNtStatusToWinError 函数将 NTSTATUS 代码转换为 Windows 错误代码。

注解

LsaCreateTrustedDomainEx 不检查指定的域名是否与指定的 SID 匹配，或者 SID 和名称是否表示实际域。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll