Funzione MprInfoBlockFind (mprapi.h)

La funzione MprInfoBlockFind individua un blocco specificato in un'intestazione di informazioni e recupera informazioni sul blocco.

Sintassi

DWORD MprInfoBlockFind(
  [in]  LPVOID  lpHeader,
  [in]  DWORD   dwInfoType,
  [out] LPDWORD lpdwItemSize,
  [out] LPDWORD lpdwItemCount,
  [out] LPBYTE  *lplpItemData
);

Parametri

[in] lpHeader

Specifica l'intestazione in cui individuare il blocco.

[in] dwInfoType

Specifica il tipo di blocco da individuare. I tipi disponibili dipendono dal trasporto: IP o IPX.

[out] lpdwItemSize

Puntatore a una variabile DWORD che riceve le dimensioni di ogni elemento nei dati del blocco individuato. Questo parametro è facoltativo e, Se questo parametro è NULL, le dimensioni dell'elemento non vengono restituite.

[out] lpdwItemCount

Puntatore a una variabile DWORD che riceve il numero di elementi di dimensioni dwItemSize contenuti nei dati del blocco. Questo parametro è facoltativo e, Se questo parametro è NULL, il conteggio degli elementi non viene restituito.

[out] lplpItemData

Puntatore a un puntatore che, in caso di esito positivo, punta ai dati per il blocco individuato. Questo parametro è facoltativo e, Se questo parametro è NULL, i dati non vengono restituiti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei valori seguenti.

Valore	Descrizione
ERROR_INVALID_PARAMETER	Il parametro lpInfoHeader è NULL.
ERROR_NOT_FOUND	Nell'intestazione non esiste alcun blocco di tipo dwInfoType .
Altri	La chiamata non è riuscita. Usare FormatMessage per recuperare il messaggio di errore corrispondente al codice di errore restituito.

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

Vedi anche

FormatMessage

Funzioni MprInfo e intestazioni di informazioni