MprAdminInterfaceDeviceGetInfo, fonction (mprapi.h)
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 |
|---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
La valeur hInterface n’est pas valide. |
|
Le paramètre lplpbBuffer est NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
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 |