Funzione LsaQueryForestTrustInformation (ntsecapi.h)

  • Articolo

La funzione LsaQueryForestTrustInformation recupera le informazioni di trust tra foreste per l'oggetto TrustedDomaindell'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