Funzione MprInfoBlockAdd (mprapi.h)
La funzione MprInfoBlockAdd crea una nuova intestazione identica a un'intestazione esistente con l'aggiunta di un nuovo blocco.
Sintassi
DWORD MprInfoBlockAdd(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[in] DWORD dwItemSize,
[in] DWORD dwItemCount,
[in] LPBYTE lpItemData,
[out] LPVOID *lplpNewHeader
);
Parametri
[in] lpHeader
Puntatore all'intestazione in cui aggiungere il nuovo blocco.
[in] dwInfoType
Specifica il tipo di blocco da aggiungere. I tipi disponibili dipendono dal trasporto: IPv4, IPv6 o IPX.
Windows Server 2008: Se dwInfoTYpe contiene IP_ROUTE_INFO, lpItemData deve puntare a una struttura INTERFACE_ROUTE_INFO .
[in] dwItemSize
Specifica le dimensioni di ogni elemento nel blocco da aggiungere.
[in] dwItemCount
Specifica il numero di elementi di dimensioni dwItemSize da copiare come dati per il nuovo blocco.
[in] lpItemData
Puntatore ai dati per il nuovo blocco. Le dimensioni in byte di questo buffer devono essere uguali al prodotto di dwItemSize e dwItemCount.
[out] lplpNewHeader
Puntatore a una variabile puntatore che, in caso di esito positivo, punta alla nuova intestazione.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei valori seguenti.
| Valore | Descrizione |
|---|---|
|
Il parametro lpHeader, lplpNewHeader o lpItemData è NULL o un blocco di tipo dwInfoType esiste già nell'intestazione. |
|
La chiamata non è riuscita. Usare FormatMessage per recuperare il messaggio di errore corrispondente al codice di errore restituito. |
Commenti
Dopo aver aggiunto un blocco di informazioni, ottenere le nuove dimensioni dell'intestazione delle informazioni chiamando MprInfoBlockQuerySize.
Requisiti
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mprapi.h |
| Libreria | Mprapi.lib |
| DLL | Mprapi.dll |