NPEnumResource 函式（npapi.h）

根據 NPOpenEnum 所傳回的控制碼執行列舉。

語法

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

[in] hEnum

從 NPOpenEnum 呼叫取得的句柄。

[in, out] lpcCount

指向所要求項目數目的指標。請求盡可能多的條目可能0xFFFFFFFF。如果呼叫成功，此位置將收到實際讀取的專案數目。

[out] lpBuffer

緩衝區的指標，以接收列舉結果，該結果會傳回為 NETRESOURCE 專案的陣列。緩衝區在下次使用 hEnum 呼叫之前有效。

[in, out] lpBufferSize

指向入口時傳遞至函式呼叫之緩衝區大小的指標（以位元組為單位）。如果緩衝區對於一個項目來說太小，則在結束時，這應該包含讀取一個項目所需的位元組數。只有在回覆碼為WN_MORE_DATA時，才會設定此值。

如果函式成功，它應該會傳回WN_SUCCESS。呼叫端可以繼續呼叫 NPEnumResource 以繼續列舉。否則，它應該傳回下列其中一個錯誤碼。

回傳碼	Description
WN_NO_MORE_ENTRIES	不再有條目。列舉已順利完成。發生這種情況時，傳回緩衝區 lpBuffer 的內容會未定義。
WN_MORE_DATA	緩衝區太小，甚至無法容納單一項目。
WN_BAD_HANDLE	hEnum 不是有效的控制碼。
WN_NO_NETWORK	網路不存在。在測試 hEnum 有效性之前，會檢查此條件。

呼叫此函式時，提供者應該以要求的專案數目（或可容納的上限）填入緩衝區。傳回的 NETRESOURCE 結構應該連續位於緩衝區的前端，就像這類結構的陣列一樣。這些結構中的指標必須指向緩衝區內的位置。因此，這些指標所參考的資料應該位於緩衝區結尾，在結構陣列之後。提供者有責任正確打包此資訊。

此頁面對您有幫助嗎？