MprAdminInterfaceTransportGetInfo-Funktion (mprapi.h)

  • Artikel

Die Funktion MprAdminInterfaceTransportGetInfo ruft Informationen zu einem Transport ab, der auf einer angegebenen Schnittstelle ausgeführt wird.

Syntax

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Parameter

[in] hMprServer

Verarbeiten Sie den Router, von dem Informationen abgerufen werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle mit der Schnittstelle. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.

[in] dwTransportId

Ein DWORD-Wert , der den Transport beschreibt, für den Informationen angefordert werden. Zulässige Werte für dwTransportId sind in der folgenden Tabelle aufgeführt.

Wert Transport (Protokollfamilie)
PID_ATALK Appletalk
PID_IP Internetprotokoll, Version 4
PID_IPX Internetpaketaustausch
PID_NBF NetBIOS Frames-Protokoll
PID_IPV6 Windows Server 2008 oder höher: Internetprotokoll, Version 6

[out] ppInterfaceInfo

Zeiger auf eine Zeigervariable. Die Zeigervariable zeigt auf einen Informationsheader, der Informationen für die angegebene Schnittstelle und den angegebenen Transport empfängt. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten. Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminBufferFree aufrufen.

[out, optional] lpdwInterfaceInfoSize

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Größe der Schnittstelleninformationen, die über den ppInterfaceInfo-Parameter zurückgegeben werden, in Bytes.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion die Größe der Schnittstelleninformationen nicht zurück.

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 Fehlercodes.

Wert Bedeutung
ERROR_ACCESS_DENIED
 Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_HANDLE
 Der hInterface-Wert ist ungültig, oder wenn die angegebene Schnittstelle administrativ deaktiviert ist.
ERROR_NO_SUCH_INTERFACE
 Der angegebene Transport wird nicht auf der angegebenen Schnittstelle ausgeführt.
ERROR_NOT_ENOUGH_MEMORY
 Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_UNKNOWN_PROTOCOL_ID
 Der wert dwTransportId stimmt mit keinem unterstützten Transport überein.

Anforderungen

   
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

Weitere Informationen

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung