Función LsaQueryTrustedDomainInfo (ntsecapi.h)

Artículo
03/15/2023

La función LsaQueryTrustedDomainInfo recupera información sobre un dominio de confianza.

Sintaxis

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parámetros

[in] PolicyHandle

Identificador del objeto Policy de un controlador de dominio que tiene una relación de confianza con el dominio identificado por el parámetro TrustedDomainSid . El identificador debe tener el derecho de acceso POLICY_VIEW_LOCAL_INFORMATION. Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] TrustedDomainSid

Puntero al SID del dominio de confianza que se va a consultar.

[in] InformationClass

Especifica uno de los valores siguientes del tipo de enumeración TRUSTED_INFORMATION_CLASS . El valor indica el tipo de información que se solicita.

Valor	Significado
TrustedDomainNameInformation	Recupera el nombre del dominio de confianza. El parámetro Buffer recibe un puntero a una estructura de TRUSTED_DOMAIN_NAME_INFO .
TrustedPosixOffsetInformation	Recupera el valor utilizado para generar identificadores de grupo y usuario de Posix para el dominio de confianza. El parámetro Buffer recibe un puntero a una estructura TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Recupera la contraseña del dominio de confianza. El parámetro Buffer recibe un puntero a una estructura de TRUSTED_PASSWORD_INFO . El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_GET_PRIVATE_INFORMATION.
TrustedDomainInformationEx	Recupera información extendida para el dominio de confianza. El parámetro Buffer recibe un puntero a una estructura de TRUSTED_DOMAIN_INFORMATION_EX .
TrustedDomainInformationBasic	Este valor no se admite.
TrustedDomainFullInformation	Recupera información completa para el dominio de confianza. Esta información incluye la información de desplazamiento posix, la información de autenticación y la información extendida devuelta para el valor TrustedDomainInformationEx. El parámetro Buffer recibe un puntero a una estructura TRUSTED_DOMAIN_FULL_INFORMATION .

[out] Buffer

Puntero a un búfer que recibe un puntero a una estructura que contiene la información solicitada. El tipo de estructura depende del valor del parámetro InformationClass .

Cuando haya terminado de usar la información, libere el puntero devuelto pasando a LsaFreeMemory.

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 valor NTSTATUS que indica el error. Para obtener más información, vea Valores devueltos de la función de directiva LSA.

Puede usar la función LsaNtStatusToWinError para convertir el valor 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