Funzione LsaQueryTrustedDomainInfo (ntsecapi.h)

Articolo
03/13/2024

La funzione LsaQueryTrustedDomainInfo recupera informazioni su un dominio attendibile.

Sintassi

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

Parametri

[in] PolicyHandle

Handle per l'oggetto Policy di un controller di dominio con una relazione di trust con il dominio identificato dal parametro TrustedDomainSid . L'handle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] TrustedDomainSid

Puntatore al SID del dominio attendibile su cui eseguire una query.

[in] InformationClass

Specifica uno dei valori seguenti dal tipo di enumerazione TRUSTED_INFORMATION_CLASS . Il valore indica il tipo di informazioni richieste.

Valore	Significato
TrustedDomainNameInformation	Recupera il nome del dominio attendibile. Il parametro Buffer riceve un puntatore a una struttura TRUSTED_DOMAIN_NAME_INFO .
TrustedPosixOffsetInformation	Recupera il valore utilizzato per generare gli identificatori utente e gruppo Posix per il dominio attendibile. Il parametro Buffer riceve un puntatore a una struttura TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Recupera la password per il dominio attendibile. Il parametro Buffer riceve un puntatore a una struttura TRUSTED_PASSWORD_INFO . L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_GET_PRIVATE_INFORMATION.
TrustedDomainInformationEx	Recupera informazioni estese per il dominio attendibile. Il parametro Buffer riceve un puntatore a una struttura TRUSTED_DOMAIN_INFORMATION_EX .
TrustedDomainInformationBasic	Questo valore non è supportato.
TrustedDomainFullInformation	Recupera le informazioni complete per il dominio attendibile. Queste informazioni includono le informazioni sull'offset Posix, le informazioni di autenticazione e le informazioni estese restituite per il valore TrustedDomainInformationEx. Il parametro Buffer riceve un puntatore a una struttura TRUSTED_DOMAIN_FULL_INFORMATION .

[out] Buffer

Puntatore a un buffer che riceve un puntatore a una struttura che contiene le informazioni richieste. Il tipo di struttura dipende dal valore del parametro InformationClass .

Al termine dell'uso delle informazioni, liberare il puntatore restituito passandolo a LsaFreeMemory.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un valore NTSTATUS che indica l'errore. Per altre informazioni, vedere Valori restituiti della funzione criteri LSA.

È possibile usare la funzione LsaNtStatusToWinError per convertire il valore NTSTATUS in un codice di errore di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecapi.h
Libreria	Advapi32.lib
DLL	Advapi32.dll