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 結構應該連續位於緩衝區的前端，例如這類結構的數位。這些結構中的指標必須指向緩衝區內的位置。因此，這些指標所參考的數據應該位於結構數位之後的緩衝區結尾。提供者必須負責正確封裝此資訊。