共用方式為

LsaEnumerateTrustedDomainsEx 函式 (ntsecapi.h)

  • 發行項

LsaEnumerateTrustedDomainsEx 函式會傳回本機系統信任之網域的相關信息。LsaEnumerateTrustedDomainsEx 只會傳回直接信任的資訊。 建議使用 DsEnumerateDomainTrusts ，以取得更完整的信任列舉目的。

語法

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

參數

[in] PolicyHandle

Policy 物件的句柄。 此呼叫需要POLICY_VIEW_LOCAL_INFORMATION 原則 物件的存取權。 如需詳細資訊，請參閱 開啟原則物件句柄。

[in] EnumerationContext

LSA_ENUMERATION_HANDLE指標，可用來對 LsaEnumerateTrustedDomainsEx 進行多個呼叫，以擷取所有受信任的網域資訊。 如需詳細資訊，請參閱＜備註＞。

[out] Buffer

緩衝區的指標，接收包含列舉信任網域相關信息的 TRUSTED_DOMAIN_INFORMATION_EX 結構清單。

當呼叫 LsaFreeMemory 不再需要此緩衝區時，您的應用程式應該釋出此緩衝區。

[in] PreferedMaximumLength

所傳回數據的慣用最大長度，以位元組為單位。 這不是硬式上限，但可作為指南。 由於不同自然數據大小的系統之間的數據轉換，傳回的實際數據量可能大於此值。

[out] CountReturned

LONG 的指標，接收傳回的受信任網域對象數目。

傳回值

如果函式成功，函式會傳回STATUS_SUCCESS。

如果函式失敗，它會傳回 NTSTATUS 程式碼，可以是下列其中一個值或其中一個 LSA原則函式傳回值。

值 Description
STATUS_ACCESS_DENIED
 呼叫端沒有適當的存取權來完成作業。
STATUS_NO_MORE_ENTRIES
 沒有其他專案。 如果未列舉任何對象，因為 EnumerationContext 值太高，就會傳回這個警告。
 

您可以使用 LsaNtStatusToWinError 函式，將 NTSTATUS 程式代碼轉換成 Windows 錯誤碼。

備註

擷取所有信任資訊可能需要多個 LsaEnumerateTrustedDomainsEx 呼叫。

若要使用 EnumerationContext 參數進行多個呼叫

  1. 將 EnumerationContext 指向的變數設定為零。
  2. 如果 LsaEnumerateTrustedDomainsEx 傳回STATUS_SUCCESS或STATUS_MORE_ENTRIES，請再次呼叫函式，並傳入上一個呼叫所傳回的 EnumerationContext 值。
  3. 當函式傳回STATUS_NO_MORE_ENTRIES時，就會完成列舉。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecapi.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX