NPEnumResource-Funktion (npapi.h)

Führt eine Aufzählung basierend auf einem von NPOpenEnum zurückgegebenen Handle aus.

Syntax

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

Die Parameter

[in] hEnum

Handle, das von einem NPOpenEnum-Aufruf abgerufen wurde.

[in, out] lpcCount

Zeigen Sie auf die Anzahl der angeforderten Einträge. Es kann 0xFFFFFFFF sein, so viele Einträge wie möglich anzufordern. Wenn der Anruf erfolgreich ist, erhält dieser Speicherort die Anzahl der Einträge, die tatsächlich gelesen wurden.

[out] lpBuffer

Zeigen Sie auf den Puffer, um das Enumerationsergebnis zu erhalten, das als Array von NETRESOURCE-Einträgen zurückgegeben wird. Der Puffer ist gültig, bis der nächste Aufruf mit hEnum verwendet wird.

[in, out] lpBufferSize

Zeigen Sie auf die Größe des Puffers in Bytes, der an den Funktionsaufruf beim Eintrag übergeben wird. Wenn der Puffer für sogar einen Eintrag zu klein ist, sollte dies beim Beenden die Anzahl der Bytes enthalten, die zum Lesen eines Eintrags erforderlich sind. Dieser Wert wird nur festgelegt, wenn der Rückgabecode WN_MORE_DATA ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben. Der Aufrufer ruft möglicherweise weiterhin NPEnumResource auf, um die Enumeration fortzusetzen. Andernfalls sollte eine der folgenden Fehlercodes zurückgegeben werden.

Bemerkungen

Wenn diese Funktion aufgerufen wird, sollte der Anbieter den Puffer mit der angeforderten Anzahl von Einträgen ausfüllen (oder das Maximum, das passt). Die zurückgegebenen NETRESOURCE-Strukturen sollten sich zusammenhängend am Anfang des Puffers befinden, z. B. ein Array solcher Strukturen. Die Zeiger in diesen Strukturen müssen auf Positionen innerhalb des Puffers verweisen. Daher sollten sich daten, auf die von diesen Zeigern verwiesen wird, am Ende des Puffers nach dem Array der Strukturen befinden. Es liegt in der Verantwortung des Anbieters, diese Informationen richtig zu verpacken.

Anforderungen