Compartir a través de

Función LsaEnumerateTrustedDomainsEx (ntsecapi.h)

  • Artículo

La función LsaEnumerateTrustedDomainsEx devuelve información sobre los dominios de confianza del sistema local. LsaEnumerateTrustedDomainsEx devuelve información solo sobre las confianzas directas. Se recomienda DsEnumerateDomainTrusts con fines de enumeración de confianza más completos.

Sintaxis

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . Esta llamada requiere POLICY_VIEW_LOCAL_INFORMATION acceso al objeto Policy . Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] EnumerationContext

Puntero a un LSA_ENUMERATION_HANDLE que puede usar para realizar varias llamadas a LsaEnumerateTrustedDomainsEx para recuperar toda la información de dominio de confianza. Para obtener más información, vea la sección Comentarios.

[out] Buffer

Puntero a un búfer que recibe una lista de TRUSTED_DOMAIN_INFORMATION_EX estructuras que contienen información sobre los dominios de confianza enumerados.

La aplicación debe liberar este búfer cuando ya no sea necesario llamando a LsaFreeMemory.

[in] PreferedMaximumLength

Longitud máxima preferida, en bytes, de datos devueltos. Esto no es un límite superior estricto, pero sirve como guía. Debido a la conversión de datos entre sistemas con diferentes tamaños de datos naturales, la cantidad real de datos devueltos puede ser mayor que este valor.

[out] CountReturned

Puntero a un long que recibe el número de objetos de dominio de confianza devueltos.

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 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.
STATUS_NO_MORE_ENTRIES
 No hay más entradas. Esta advertencia se devuelve si no se han enumerado objetos porque el valor EnumerationContext es demasiado alto.
 

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

Comentarios

Recuperar toda la información de confianza puede requerir más de una sola llamada a LsaEnumerateTrustedDomainsEx .

Para usar el parámetro EnumerationContext para realizar varias llamadas

  1. Establezca la variable a la que apunta EnumerationContext en cero.
  2. Si LsaEnumerateTrustedDomainsEx devuelve STATUS_SUCCESS o STATUS_MORE_ENTRIES, llame a la función de nuevo y pase el valor EnumerationContext devuelto por la llamada anterior.
  3. La enumeración se completa cuando la función devuelve STATUS_NO_MORE_ENTRIES.

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

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX