Funzione LsaQueryTrustedDomainInfoByName (ntsecapi.h)

  • Articolo

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