Función LsaSetTrustedDomainInformation (ntsecapi.h)
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 |
|---|---|
|
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. |
|
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 . |
|
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 |