MprInfoBlockAdd-Funktion (mprapi.h)
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 |
|---|---|
|
Der Parameter lpHeader, lplpNewHeader oder lpItemData ist NULL, oder ein Block vom Typ dwInfoType ist bereits im Header vorhanden. |
|
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 |