Función LsaOpenTrustedDomainByName (ntsecapi.h)

La función LsaOpenTrustedDomainByName abre el identificador de directiva LSA de un dominio de confianza remoto. Puede pasar este identificador a las llamadas de función LSA para establecer o consultar la directiva LSA de la máquina remota.

Sintaxis

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . Este es el identificador de directiva de la máquina local. Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] TrustedDomainName

Nombre del dominio de confianza. Este nombre puede ser el nombre plano o el nombre de dominio del Sistema de nombres de dominio (DNS).

[in] DesiredAccess

Estructura ACCESS_MASK que especifica los permisos de acceso solicitados en el objeto de dominio de confianza remoto.

[out] TrustedDomainHandle

Puntero que recibe la dirección del identificador de directiva LSA del dominio de confianza remoto. Puede pasar este identificador a las llamadas de función LSA para consultar y administrar la directiva LSA de la máquina remota.

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

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es 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.

Valor	Descripción
STATUS_ACCESS_DENIED	El autor de la llamada no tiene el acceso adecuado para completar la operación.
STATUS_OBJECT_NAME_NOT_FOUND	No hay ningún objeto Dominio de confianza en la base de datos LSA del sistema de destino que tenga el nombre especificado.

 

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

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

Consulte también

LsaClose