Función LsaCreateTrustedDomainEx (ntsecapi.h)

Artículo
03/05/2024

La función LsaCreateTrustedDomainEx establece un nuevo dominio de confianza mediante la creación de un nuevo objeto TrustedDomain .

Sintaxis

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
);

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . Para que se cree el objeto, el autor de la llamada debe tener permiso para crear elementos secundarios en el contenedor del sistema . Para obtener información sobre los identificadores de objetos de directiva, vea Apertura de un identificador de objeto de directiva.

[in] TrustedDomainInformation

Puntero a una estructura de TRUSTED_DOMAIN_INFORMATION_EX que contiene el nombre y el SID del nuevo dominio de confianza.

[in] AuthenticationInformation

Puntero a una estructura de TRUSTED_DOMAIN_AUTH_INFORMATION que contiene información de autenticación para el nuevo dominio de confianza.

[in] DesiredAccess

Estructura ACCESS_MASK que especifica los accesos que se van a conceder para el nuevo dominio de confianza.

[out] TrustedDomainHandle

Recibe el identificador de directiva LSA del dominio de confianza remoto. Puede pasar este identificador a las llamadas de función LSA para administrar la directiva LSA del dominio de confianza.

Cuando la aplicación ya no necesite este identificador, debe llamar a LsaClose para eliminar el identificador.

Valor devuelto

Si la función se realiza correctamente, la función devuelve STATUS_SUCCESS.

Si se produce un error en la función, devuelve un código NTSTATUS , que puede ser uno de los siguientes valores o uno de los valores devueltos de la función de directiva LSA.

Código devuelto	Descripción
STATUS_DIRECTORY_SERVICE_REQUIRED	El sistema de destino (especificado en el parámetro TrustedDomainInformation ) del objeto TrustedDomain no es un controlador de dominio.
STATUS_INVALID_SID	El SID especificado no es válido.
STATUS_UNSUCCESSFUL	No se puede determinar si el sistema de destino es un controlador de dominio.

Puede usar la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

Comentarios

LsaCreateTrustedDomainEx no comprueba si el nombre de dominio especificado coincide con el SID especificado o si el SID y el nombre representan un dominio real.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecapi.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll