Funzione LsaQueryForestTrustInformation (ntsecapi.h)

Articolo
08/25/2023

La funzione LsaQueryForestTrustInformation recupera le informazioni di trust tra foreste per l'oggetto TrustedDomain dell'autorità di sicurezza locale specificato.

Sintassi

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Parametri

[in] PolicyHandle

Handle per l'oggetto Policy per il sistema.

[in] TrustedDomainName

Puntatore a una struttura LSA_UNICODE_STRING che contiene il nome dell'oggetto TrustedDomain per cui recuperare le informazioni di trust tra foreste.

[out] ForestTrustInfo

Puntatore a una struttura LSA_FOREST_TRUST_INFORMATION che restituisce le informazioni di trust tra foreste per l'oggetto TrustedDomain specificato dal parametro TrustedDomainName .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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.

Codice/valore restituito	Descrizione
STATUS_INVALID_DOMAIN_ROLE	L'operazione è legale solo nel controller di dominio primario.
STATUS_INVALID_DOMAIN_STATE	L'operazione è legale solo nei controller di dominio nel dominio radice.
STATUS_NO_SUCH_DOMAIN	L'oggetto TrustedDomain specificato non esiste.
STATUS_NOT_FOUND	L'oggetto TrustedDomain specificato non contiene informazioni di trust tra foreste.

Commenti

L'accesso a questa funzione è protetto da un oggetto a protezione diretta.

Requisiti

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

Condividi tramite