MprInfoBlockFind-Funktion (mprapi.h)
Die MprInfoBlockFind-Funktion sucht einen angegebenen Block in einem Informationsheader und ruft Informationen zum Block ab.
Syntax
DWORD MprInfoBlockFind(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[out] LPDWORD lpdwItemSize,
[out] LPDWORD lpdwItemCount,
[out] LPBYTE *lplpItemData
);
Parameter
[in] lpHeader
Gibt den Header an, in dem der Block gefunden werden soll.
[in] dwInfoType
Gibt den Typ des zu suchenden Blocks an. Die verfügbaren Typen hängen vom Transport ab: IP oder IPX.
[out] lpdwItemSize
Zeiger auf eine DWORD-Variable , die die Größe jedes Elements in den Daten des lokalisierten Blocks empfängt. Dieser Parameter ist optional. Wenn dieser Parameter NULL ist, wird die Elementgröße nicht zurückgegeben.
[out] lpdwItemCount
Zeiger auf eine DWORD-Variable , die die Anzahl der Elemente der Größe dwItemSize empfängt, die in den Daten des Blocks enthalten sind. Dieser Parameter ist optional. Wenn dieser Parameter NULL ist, wird die Elementanzahl nicht zurückgegeben.
[out] lplpItemData
Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe auf die Daten für den lokalisierten Block verweist. Dieser Parameter ist optional. Wenn dieser Parameter NULL ist, werden die Daten nicht zurückgegeben.
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 lpInfoHeader-Parameter ist NULL. |
|
Im Header ist kein Block vom Typ dwInfoType vorhanden. |
|
Der Aufruf schlug fehl. Verwenden Sie FormatMessage , um die Fehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
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 |