Función MprConfigTransportEnum (mprapi.h)
La función MprConfigTransportEnum enumera los transportes configurados en el enrutador.
Sintaxis
DWORD MprConfigTransportEnum(
[in] HANDLE hMprConfig,
[in] DWORD dwLevel,
[in, out] LPBYTE *lplpBuffer,
[in] DWORD dwPrefMaxLen,
[out] LPDWORD lpdwEntriesRead,
[out] LPDWORD lpdwTotalEntries,
[in, out, optional] LPDWORD lpdwResumeHandle
);
Parámetros
[in] hMprConfig
Controle la configuración del enrutador para los transportes. Obtenga este identificador llamando a MprConfigServerConnect.
[in] dwLevel
Valor DWORD que describe el formato en el que se devuelve la información en el parámetro lplpBuffer . Debe ser cero.
[in, out] lplpBuffer
En la entrada, un puntero distinto de NULL .
Al finalizar correctamente, un puntero a una matriz de estructuras de MPR_TRANSPORT_0 . Libere este búfer de memoria llamando a MprConfigBufferFree.
[in] dwPrefMaxLen
Especifica la longitud máxima preferida de los datos devueltos en bytes de 8 bits. Si este parámetro es -1, el búfer devuelto será lo suficientemente grande como para contener toda la información disponible.
[out] lpdwEntriesRead
Puntero a una variable DWORD . Esta variable recibe el número total de entradas enumeradas a partir de la posición de reanudación actual.
[out] lpdwTotalEntries
Puntero a una variable DWORD . Esta variable recibe el número total de entradas que se podrían haber enumerado a partir de la posición de reanudación actual.
[in, out, optional] lpdwResumeHandle
Puntero a una variable DWORD .
En la entrada, el identificador debe ser cero en la primera llamada y dejar sin cambios en las llamadas posteriores.
En la salida, esta variable contiene un identificador de reanudación que se usa para continuar con la enumeración. Si el identificador es NULL, la enumeración se completa.
Si se produce un error en la enumeración, este identificador no es válido.
Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve un identificador de reanudación.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
Se cumple al menos una de las siguientes condiciones:
|
|
Recursos insuficientes para completar la operación. |
|
No hay más entradas disponibles en la posición de reanudación actual. |
|
Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mprapi.h |
| Library | Mprapi.lib |
| Archivo DLL | Mprapi.dll |