MprInfoBlockAdd-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprInfoBlockAdd-Funktion erstellt einen neuen Header, der mit einem vorhandenen Header identisch ist, wobei ein neuer Block hinzugefügt wird.

Syntax

DWORD MprInfoBlockAdd(
  [in]  LPVOID lpHeader,
  [in]  DWORD  dwInfoType,
  [in]  DWORD  dwItemSize,
  [in]  DWORD  dwItemCount,
  [in]  LPBYTE lpItemData,
  [out] LPVOID *lplpNewHeader
);

Parameter

[in] lpHeader

Zeiger auf den Header, in dem der neue Block hinzugefügt werden soll.

[in] dwInfoType

Gibt den Typ des hinzuzufügenden Blocks an. Die verfügbaren Typen hängen vom Transport ab: IPv4, IPv6 oder IPX.

Windows Server 2008: Wenn dwInfoTYpeIP_ROUTE_INFO enthält, muss lpItemData auf eine INTERFACE_ROUTE_INFO-Struktur verweisen.

[in] dwItemSize

Gibt die Größe der einzelnen Elemente im hinzuzufügenden Block an.

[in] dwItemCount

Gibt die Anzahl der Elemente der Größe dwItemSize an, die als Daten für den neuen Block kopiert werden sollen.

[in] lpItemData

Zeiger auf die Daten für den neuen Block. Die Größe dieses Puffers in Bytes sollte dem Produkt von dwItemSize und dwItemCount entsprechen.

[out] lplpNewHeader

Zeiger auf eine Zeigervariable, die bei erfolgreicher Rückgabe auf den neuen Header zeigt.

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_INVALID_PARAMETER	Der Parameter lpHeader, lplpNewHeader oder lpItemData ist NULL, oder ein Block vom Typ dwInfoType ist bereits im Header vorhanden.
Andere	Der Aufruf schlug fehl. Verwenden Sie FormatMessage , um die Fehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Rufen Sie nach dem Hinzufügen eines Informationsblocks die neue Größe des Informationsheaders ab, indem Sie MprInfoBlockQuerySize aufrufen.

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