MprAdminPortGetInfo, fonction (mprapi.h)

Article
02/29/2024

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

Partager via