Función LsaQueryTrustedDomainInfoByName (ntsecapi.h)

  • Artículo

La función LsaQueryTrustedDomainInfoByName devuelve información sobre un dominio de confianza.

Sintaxis

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . Este 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] TrustedDomainName

Cadena que contiene el nombre del dominio de confianza. Puede ser el nombre de dominio o el nombre plano.

[in] InformationClass

Especifica el tipo de información que se va a recuperar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
TrustedDomainNameInformation
 Nombre del dominio de confianza.
TrustedPosixInformation
 Desplazamiento posix del dominio de confianza.
TrustedPasswordInformation
 Devuelve la contraseña en el lado saliente de la confianza.
TrustedDomainInformationBasic
 Este valor no se admite.
TrustedDomainInformationEx
 Información de confianza extendida, incluida la información básica y el nombre de dominio DNS, y los atributos sobre la confianza.
TrustedDomainFullInformation
 Información completa, incluido el desplazamiento posix y la información de autenticación.

[out] Buffer

Recibe un puntero al búfer devuelto que contiene la información solicitada. El formato y el contenido de este búfer dependen de la clase de información. Por ejemplo, si InformationClass está establecido en TrustedDomainInformationEx, Buffer recibe un puntero a una estructura de TRUSTED_DOMAIN_INFORMATION_EX . Para obtener más información, consulte TRUSTED_INFORMATION_CLASS.

Cuando haya terminado de usar el búfer, liberelo llamando a la función 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 puede ser uno de los valores siguientes 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. Para obtener una lista de los tipos de acceso necesarios, vea la descripción del parámetro InformationClass .
RECURSOS de STATUS_INSUFFICIENT_
 Recursos del sistema insuficientes, como la memoria, para completar la llamada.
 

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

Consulte también

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS