Funzione LsaQueryTrustedDomainInfoByName (ntsecapi.h)

Articolo
08/25/2023

La funzione LsaQueryTrustedDomainInfoByName restituisce informazioni su un dominio attendibile.

Sintassi

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

Parametri

[in] PolicyHandle

Handle a un oggetto Policy . Questo handle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] TrustedDomainName

Stringa contenente il nome del dominio attendibile. Può essere il nome di dominio o il nome flat.

[in] InformationClass

Specifica il tipo di informazioni da recuperare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TrustedDomainNameInformation	Nome del dominio attendibile.
TrustedPosixInformation	Offset posix del dominio attendibile.
TrustedPasswordInformation	Restituisce la password sul lato in uscita dell'attendibilità.
TrustedDomainInformationBasic	Questo valore non è supportato.
TrustedDomainInformationEx	Informazioni di attendibilità estese, incluse le informazioni di base e il nome di dominio DNS e gli attributi relativi all'attendibilità.
TrustedDomainFullInformation	Informazioni complete, tra cui l'offset Posix e le informazioni di autenticazione.

[out] Buffer

Riceve un puntatore al buffer restituito contenente le informazioni richieste. Il formato e il contenuto di questo buffer dipendono dalla classe di informazioni. Ad esempio, se InformationClass è impostato su TrustedDomainInformationEx, buffer riceve un puntatore a una struttura TRUSTED_DOMAIN_INFORMATION_EX . Per altre informazioni, vedere TRUSTED_INFORMATION_CLASS.

Al termine dell'uso del buffer, liberarlo chiamando la funzione 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 può essere uno dei valori seguenti o uno dei valori restituiti della funzione Criteri LSA.

Valore	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato per completare l'operazione. Per un elenco dei tipi di accesso necessari, vedere la descrizione del parametro InformationClass .
risorse STATUS_INSUFFICIENT_	Risorse di sistema insufficienti, ad esempio memoria, per completare la chiamata.

È 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

Vedi anche

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS

Condividi tramite