WNetEnumResourceA 函式（winnetwk.h）

WNetEnumResource 函式會繼續列舉由呼叫 WNetOpenEnum 函式所啟動的網路資源。

語法

DWORD WNetEnumResourceA(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

[in] hEnum

識別列舉實例的句柄。此句柄必須由 WNetOpenEnum 函式傳回。

[in, out] lpcCount

指定所要求項目數之變數的指標。如果所要求的數位是 –1，函式會傳回盡可能多的專案。

如果函式成功，則傳回此參數所指向的變數包含實際讀取的項目數。

[out] lpBuffer

接收列舉結果之緩衝區的指標。結果會以 NETRESOURCE 結構的陣列傳回。請注意，您配置的緩衝區必須夠大，才能保存結構，加上其成員指向的字串。如需詳細資訊，請參閱下列一節。

緩衝區有效，直到使用 hEnum 參數所指定的句柄的下一個呼叫為止。陣列中 NETRESOURCE 結構的順序無法預測。

[in, out] lpBufferSize

變數的指標，指定 lpBuffer 參數的大小，以位元組為單位。如果緩衝區太小而無法接收一個專案，此參數就會接收所需的緩衝區大小。

如果函式成功，傳回值就是下列其中一個值。

傳回碼	描述
NO_ERROR	列舉成功，且緩衝區包含要求的數據。呼叫端應用程式可以繼續呼叫 WNetEnumResource 來完成列舉。
ERROR_NO_MORE_ITEMS	沒有其他專案。未定義緩衝區內容。

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

傳回碼	描述
ERROR_MORE_DATA	後續呼叫會提供更多專案。如需詳細資訊，請參閱下列一節。
ERROR_INVALID_HANDLE	hEnum 參數指定的句柄無效。
ERROR_NO_NETWORK	網路無法使用。（此條件是在 hEnum 測試有效性之前進行測試。
ERROR_EXTENDED_ERROR	發生網路特定錯誤。若要取得錯誤的描述，請呼叫 WNetGetLastError 函式。

WNetEnumResource 函式不會列舉連線到共用的使用者;您可以呼叫 NetConnectionEnum 函式來完成這項工作。若要列舉隱藏共用，請呼叫 NetShareEnum 函式。

應用程式無法將 lpBuffer 參數設定為 NULL，並從 lpBufferSize 參數擷取所需的緩衝區大小。相反地，應用程式應該配置合理大小的緩衝區—16 KB 是典型的，並使用 lpBufferSize 的值來進行錯誤偵測。

如需說明列舉網路上所有資源之應用程式定義函式的程式代碼範例，請參閱列舉網路資源。

注意

winnetwk.h 標頭會根據 UNICODE 預處理器常數的定義，將 WNetEnumResource 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winnetwk.h
連結庫	Mpr.lib
DLL	Mpr.dll