MprAdminPortGetInfo, fonction (mprapi.h)

  • Article

La fonction MprAdminPortGetInfo obtient des informations pour un port spécifique.

Syntaxe

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

Paramètres

[in] hRasServer

Gérez vers l’ordinateur serveur RAS sur lequel collecter les informations de port. Obtenez ce handle en appelant MprAdminServerConnect.

[in] dwLevel

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

Valeur Structure Format
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

Gérez vers le port pour lequel collecter des informations. Obtenez ce handle en appelant MprAdminPortEnum.

[out] lplpbBuffer

En cas de réussite de l’exécution, pointeur vers une structure qui décrit le port. Ces structures sont de type RAS_PORT_0 ou RAS_PORT_1 en fonction de la valeur du paramètre dwLevel . 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_DDM_NOT_RUNNING
 Le Gestionnaire de numérotation de la demande (DDM) n’est pas en cours d’exécution, peut-être parce que le Gestionnaire d’interface dynamique (DIM) est configuré pour s’exécuter uniquement sur un réseau local.
ERROR_INVALID_PARAMETER
 Au moins l’un des paramètres suivants est NULL ou ne pointe pas vers la mémoire valide : lplpBuffer, lpdwEntriesRead ou lpdwTotalEntries.
ERROR_INVALID_PORT_HANDLE
 Le paramètre hPort n’est pas valide.
ERROR_NOT_SUPPORTED
 Le paramètre dwLevel n’est pas égal à zéro.
Autres
 Erreur de MprError.h, RasError.h ou WinError.h.
 
 

Remarques

Cette fonction est disponible sur Windows NT 4.0 si le redistribuable RRAS est installé. Toutefois, la version de Mprapi.dll fournie avec le redistribuable RRAS exporte la fonction en tant que RasAdminPortGetInfo plutôt que MprAdminPortGetInfo. Par conséquent, lorsque vous utilisez le redistribuable RRAS, utilisez LoadLibrary et GetProcAddress pour accéder à cette fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
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

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

Fonctions d’administration RAS

Informations de référence sur l’administration du service d’accès à distance