共用方式為

NetAccessEnum 函式 (lmaccess.h)

  • 發行項

[此函式已過時。 如需替代函式的清單，請參閱 Authorization Functions。]

不支援。

NetAccessEnum 函式會擷取每個訪問許可權記錄的相關信息。

語法

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

參數

servername

字串的指標，指定要在其中執行函式之遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 NULL，則會使用本機電腦。

BasePath

字串的指標，其中包含資源的基底路徑名稱。 NULL 指標或 NULL 字串表示不會使用基底路徑。 路徑可以指定為通用命名慣例， (UNC) pathname。

Recursive

指定啟用或停用遞歸搜尋的旗標。

如果此參數等於零， NetAccessEnum 函式會傳回 pszBasePath 參數命名為基底路徑的資源專案，以及該基底路徑正下方的資源。

如果此參數為非零，則函式會傳回所有訪問控制清單的專案， (ACL) 資源名稱開頭有 pszBasePath 。

level

指定資料的資訊層級。 此參數可以是下列其中一個值。

值 意義
0
 pbBuffer 參數會指向access_info_0結構。
1
 pbBuffer 參數會指向access_info_1結構。

bufptr

接收存取信息結構的緩衝區指標。 此數據的格式取決於 sLevel 參數的值。

prefmaxlen

指定 pbBuffer 參數所指向緩衝區的大小，以位元組為單位。

entriesread

接收實際列舉專案計數之不帶正負號短整數的指標。 只有在 NetAccessEnum 函式傳回 NERR_Success 或 ERROR_MORE_DATA時，計數才有效。

totalentries

不帶正負號的短整數指標，該整數會接收可能已列舉的項目總數。 只有在 NetAccessEnum 函式傳回 NERR_Success 或 ERROR_MORE_DATA時，計數才有效。

resume_handle

TBD

傳回值

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

如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。

備註

此函式需要 管理員 許可權，才能成功在已啟用本機安全性的計算機上執行。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 lmaccess.h (包含 Lm.h、Lmaccess.h)
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

授權函式