MprConfigGetFriendlyName, fonction (mprapi.h)

La fonction MprConfigGetFriendlyName retourne le nom convivial d’une interface qui correspond au nom GUID spécifié.

Syntaxe

DWORD MprConfigGetFriendlyName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszGuidName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

[in] hMprConfig

Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.

[in] pszGuidName

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom guid de l’interface.

[out] pszBuffer

Pointeur vers une mémoire tampon qui reçoit le nom convivial de l’interface.

[in] dwBufferSize

Spécifie la taille, en octets, de la mémoire tampon pointée par pszBuffer.

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_BUFFER_OVERFLOW	La mémoire tampon pointée par pszBuffer n’est pas assez grande pour contenir le nom GUID retourné.
ERROR_INVALID_PARAMETER	L’un des paramètres suivants hMprConfig, pszGuidName ou pszBuffer est NULL.
ERROR_NOT_FOUND	Aucun nom GUID correspondant au nom convivial spécifié n’a été trouvé.

Condition requise	Valeur
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