Funzione LsaOpenTrustedDomainByName (ntsecapi.h)

Articolo
03/15/2023

La funzione LsaOpenTrustedDomainByName apre l'handle dei criteri LSA di un dominio attendibile remoto. È possibile passare questo handle alle chiamate di funzione LSA per impostare o eseguire query sui criteri LSA del computer remoto.

Sintassi

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Parametri

[in] PolicyHandle

Handle a un oggetto Policy . Si tratta dell'handle dei criteri del computer locale. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] TrustedDomainName

Nome del dominio attendibile. Questo nome può essere il nome flat o il nome di dominio DNS (Domain Name System).

[in] DesiredAccess

Struttura ACCESS_MASK che specifica le autorizzazioni di accesso richieste nell'oggetto dominio attendibile remoto.

[out] TrustedDomainHandle

Puntatore che riceve l'indirizzo dell'handle dei criteri LSA del dominio attendibile remoto. È possibile passare questo handle alle chiamate di funzione LSA per eseguire query e gestire i criteri LSA del computer remoto.

Quando l'applicazione non ha più bisogno di questo handle, deve chiamare LsaClose per eliminare l'handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice 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.
STATUS_OBJECT_NAME_NOT_FOUND	Non esiste alcun oggetto Domain attendibile nel database LSA del sistema di destinazione con il nome specificato.

È possibile usare la funzione LsaNtStatusToWinError per convertire il codice 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

LsaClose

Condividi tramite