Función LsaSetTrustedDomainInformation (ntsecapi.h)

  • Artículo

La función LsaSetTrustedDomainInformation modifica la información de un objeto Policy sobre un dominio de confianza.

Sintaxis

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

Parámetros

[in] PolicyHandle

Identificador del objeto Policy de un controlador de dominio. Los derechos de usuario necesarios para este identificador dependen del valor del parámetro InformationClass . Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] TrustedDomainSid

Puntero al SID del dominio de confianza cuya información se modifica. Si el parámetro InformationClass se establece en TrustedDomainNameInformation, este parámetro debe apuntar al SID del dominio para agregar a la lista de dominios de confianza.

[in] InformationClass

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

Valor Significado
TrustedDomainNameInformation
 Si el dominio especificado no está en la lista de dominios de confianza, la función LsaSetTrustedDomainInformation la agrega. El parámetro TrustedDomainSid debe ser el SID del dominio que se va a agregar. El parámetro Buffer debe ser un puntero a una estructura de TRUSTED_DOMAIN_NAME_INFO que contenga el nombre del dominio que se va a agregar.

Si el dominio especificado ya está en la lista de dominios de confianza, se produce un error en la función.
TrustedPosixOffsetInformation
 Establece el valor usado para generar identificadores de grupo y usuario de Posix. El parámetro Buffer debe ser un puntero a una estructura de TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation
 Establece la contraseña del dominio de confianza. El parámetro Buffer debe ser un puntero a una estructura de TRUSTED_PASSWORD_INFO que contenga las contraseñas antiguas y nuevas para el dominio especificado. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_CREATE_SECRET. La cadena de contraseña antigua puede ser NULL.

[in] Buffer

Puntero a una estructura que contiene la información que se va a establecer. El tipo de estructura depende del valor del parámetro InformationClass .

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. 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 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

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO