共用方式為

NetGetDisplayInformationIndex 函式 (lmaccess.h)

  • 發行項

NetGetDisplayInformationIndex函式會傳回第一個顯示資訊專案的索引，其名稱開頭為指定的字串，或名稱依字母順序排列在字串後面。 您可以使用此函式來判斷 NetQueryDisplayInformation 函式後續呼叫的起始索引。

語法

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

參數

[in] ServerName

常數位符串的指標，指定函式執行所在遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null，則會使用本機電腦。

[in] Level

指定要查詢的帳戶層級。 此參數可以是下列其中一個值。

值 意義
1
 查詢所有本機和全域 (一般) 使用者帳戶。
2
 查詢所有工作站和伺服器使用者帳戶。
3
 查詢所有全域群組。

[in] Prefix

字串的指標，指定要搜尋的前置詞。

[out] Index

接收所要求專案索引的值指標。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼 描述
ERROR_ACCESS_DENIED
 使用者無法存取要求的資訊。
ERROR_INVALID_LEVEL
 針對 Level 參數指定的值無效。
ERROR_NO_MORE_ITEMS
 沒有其他要操作的專案。
NERR_InvalidComputer
 電腦名稱無效。

備註

如果您在執行 Active Directory 的網域控制站上呼叫此函式，則會根據 安全性實體物件的存取控制清單 (ACL) ，允許或拒絕存取。 預設 ACL 允許所有已驗證的使用者和「Windows 2000 相容存取」群組的成員檢視資訊。 如果您在成員伺服器或工作站上呼叫此函式，所有已驗證的使用者都可以檢視資訊。 如需有關匿名存取和限制這些平臺上匿名存取的資訊，請參閱 網路管理功能的安全性需求。 如需 ACL、ACE 和存取權杖的詳細資訊，請參閱存取控制模型。

函式只會傳回呼叫端具有讀取權限的資訊。 呼叫端必須具有 Domain 物件的 List Contents 存取權，並在位於系統容器的 SAM Server 物件上列舉整個 SAM 網域存取權。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 lmaccess.h (包括 Lm.h)
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

取得函式

NetQueryDisplayInformation

網路管理功能

網路管理概觀