MprAdminInterfaceDeviceGetInfo, fonction (mprapi.h)

Article
08/24/2023

MprAdminInterfaceDeviceGetInfo récupère des informations sur un appareil utilisé dans une interface de numérotation à la demande d’un routeur.

Syntaxe

DWORD MprAdminInterfaceDeviceGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwIndex,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpBuffer
);

Paramètres

[in] hMprServer

Gérez vers le routeur sur lequel exécuter cet appel. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hInterface

Handle vers l’interface. Obtenez ce handle à partir d’un appel précédent à MprAdminInterfaceCreate, ou en appelant MprAdminInterfaceEnum

[in] dwIndex

Spécifie l’index de base un de l’appareil. Une interface de numérotation à la demande multirésente utilise plusieurs appareils.

[in] dwLevel

Valeur DWORD qui décrit le format dans lequel les informations sont retournées dans le paramètre lplpBuffer . Les valeurs acceptables pour dwLevel incluent 0 ou 1, comme indiqué dans le tableau suivant.

Valeur	Structure Format
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[out] lplpBuffer

En cas de réussite de l’exécution, pointeur vers une structure MPR_DEVICE_0 ou MPR_DEVICE_1 . Le paramètre dwLevel indique le type de structure. Libérez cette mémoire en appelant MprAdminBufferFree.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_INVALID_HANDLE	La valeur hInterface n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre lplpbBuffer est NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NOT_SUPPORTED	La valeur dwLevel n’est pas valide.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll

Voir aussi

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceSetInfo

Share via