NetFileGetInfo 函式 (lmshare.h)

  • 發行項

擷取伺服器資源之特定開啟的相關資訊。

語法

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

參數

[in] servername

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

如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

[in] fileid

指定要傳回信息之開啟資源的檔案識別碼。 這個參數的值必須在先前的列舉呼叫中傳回。 如需詳細資訊，請參閱接下來的＜備註＞一節。

[in] level

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

值 意義
2
 傳回檔案識別碼。 bufptr參數是FILE_INFO_2結構的指標。
3
 傳回檔案識別碼和其他檔案的相關資訊。 bufptr參數是FILE_INFO_3結構的指標。

[out] bufptr

接收資訊的緩衝區位址指標。 此資料的格式取決於 level 參數的值。 此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。 如需詳細資訊，請參閱 網路管理功能緩衝區 和 網路管理功能緩衝區長度。

傳回值

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

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

傳回碼 描述
ERROR_ACCESS_DENIED
 使用者無法存取要求的資訊。
ERROR_FILE_NOT_FOUND
 找不到檔案。
ERROR_INVALID_LEVEL
 為 level 參數指定的值無效。
ERROR_NOT_ENOUGH_MEMORY
 記憶體不足。
NERR_BufTooSmall
 提供的緩衝區太小。

備註

只有 Administrators 或伺服器操作員本機群組的成員才能成功執行 NetFileGetInfo 函式。

您可以呼叫 NetFileEnum 函式，以擷取伺服器上開啟之多個檔案的相關資訊。

如果您是針對 Active Directory 進行程式設計，您可以呼叫特定 Active Directory 服務介面 (ADSI) 方法來達成相同的功能，方法是呼叫 NetFileGetInfo。 如需詳細資訊，請參閱 IADsResource 和 IADsFileServiceOperations。

需求

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

另請參閱

FILE_INFO_2

FILE_INFO_3

NetFile 函式

NetFileEnum

網路管理功能

網路管理概觀