MprAdminMIBEntryGetFirst-Funktion (mprapi.h)

Artikel
03/04/2024

Die MprAdminMIBEntryGetFirst-Funktion ruft die erste Variable einer Gruppe von Variablen ab, die von einem Protokoll- oder Router-Manager exportiert werden. Das Modul, das den Aufruf bereitstellt, definiert zuerst.

Syntax

DWORD MprAdminMIBEntryGetFirst(
  [in]  MIB_SERVER_HANDLE hMibServer,
  [in]  DWORD             dwProtocolId,
  [in]  DWORD             dwRoutingPid,
  [in]  LPVOID            lpInEntry,
  [in]  DWORD             dwInEntrySize,
  [out] LPVOID            *lplpOutEntry,
  [out] LPDWORD           lpOutEntrySize
);

Parameter

[in] hMibServer

Verarbeiten Sie den Router, auf dem dieser Aufruf ausgeführt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminMIBServerConnect aufrufen.

[in] dwProtocolId

Gibt den Router-Manager an , der die Variable exportiert hat.

[in] dwRoutingPid

Gibt das Routingprotokoll an , das die Variable exportiert hat.

[in] lpInEntry

Zeiger auf eine undurchsichtige Datenstruktur. Das Format der Datenstruktur wird durch das Modul bestimmt, das den Aufruf verwaltet. Die Datenstruktur sollte Informationen enthalten, die die abgefragte Variable angeben.

[in] dwInEntrySize

Gibt die Größe der Daten in Bytes an, auf die von lpInEntry verwiesen wird.

[out] lplpOutEntry

Zeiger auf eine Zeigervariable. Bei erfolgreicher Rückgabe verweist diese Zeigervariable auf eine undurchsichtige Datenstruktur. Das Format der Datenstruktur wird durch das Modul bestimmt, das den Aufruf verwaltet. Die Datenstruktur empfängt den Wert der ersten Variablen aus dem Satz exportierter Variablen. Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminMIBBufferFree aufrufen.

[out] lpOutEntrySize

Zeiger auf eine DWORD-Variable . Bei erfolgreicher Rückgabe empfängt diese Variable die Größe der Datenstruktur in Bytes, die über den lplpOutEntry-Parameter zurückgegeben wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Werte.

Wert	BESCHREIBUNG
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen.
ERROR_CANNOT_COMPLETE	Die dwRoutingPid-Variable entspricht keinem installierten Routingprotokoll.
ERROR_UNKNOWN_PROTOCOL_ID	Der dwTransportId-Wert stimmt mit keinem installierten Transport-/Router-Manager überein.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.

Hinweise

Übergeben Sie nicht NULL für den lpInEntry-Parameter , da das resultierende Verhalten nicht definiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll