Fonction MprConfigGetGuidName (mprapi.h)

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

Syntaxe

DWORD MprConfigGetGuidName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszFriendlyName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

[in] hMprConfig

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

[in] pszFriendlyName

Pointeur vers une chaîne Unicode qui spécifie le nom convivial de l’interface.

[out] pszBuffer

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

[in] dwBufferSize

Spécifie la taille, en octets, de la mémoire tampon pointée vers 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 vers pszBuffer n’est pas assez grande pour contenir le nom GUID retourné.
ERROR_INVALID_PARAMETER	Au moins un des paramètres hMprConfig, pszFriendlyName 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