Función MprAdminInterfaceDeviceGetInfo (mprapi.h)
MprAdminInterfaceDeviceGetInfo recupera información sobre un dispositivo que se usa en una interfaz de marcado a petición del enrutador.
Sintaxis
DWORD MprAdminInterfaceDeviceGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwIndex,
[in] DWORD dwLevel,
[out] LPBYTE *lplpBuffer
);
Parámetros
[in] hMprServer
Identificador del enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminServerConnect.
[in] hInterface
Identificador de la interfaz. Obtenga este identificador de una llamada anterior a MprAdminInterfaceCreate o llamando a MprAdminInterfaceEnum.
[in] dwIndex
Especifica el índice basado en uno del dispositivo. Una interfaz multi linked demand-dial usa varios dispositivos.
[in] dwLevel
Valor DWORD que describe el formato en el que se devuelve la información en el parámetro lplpBuffer . Los valores aceptables para dwLevel incluyen 0 o 1, como se muestra en la tabla siguiente.
| Valor | Formato de estructura |
|---|---|
| 0 | MPR_DEVICE_0 |
| 1 | MPR_DEVICE_1 |
[out] lplpBuffer
Al finalizar correctamente, un puntero a una estructura de MPR_DEVICE_0 o MPR_DEVICE_1 . El parámetro dwLevel indica el tipo de estructura. Libere esta memoria llamando a MprAdminBufferFree.
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 |
|---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
El valor hInterface no es válido. |
|
El parámetro lplpbBuffer es NULL. |
|
Recursos insuficientes para completar la operación. |
|
El valor dwLevel no es válido. |
Requisitos
| 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 |