Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |