Función MprConfigGetFriendlyName (mprapi.h)

La función MprConfigGetFriendlyName devuelve el nombre descriptivo de una interfaz que corresponde al nombre GUID especificado.

Sintaxis

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

[in] hMprConfig

Controle la configuración del enrutador. Obtenga este identificador llamando a MprConfigServerConnect.

[in] pszGuidName

Puntero a una cadena Unicode terminada en null que especifica el nombre GUID de la interfaz.

[out] pszBuffer

Puntero a un búfer que recibe el nombre descriptivo de la interfaz.

[in] dwBufferSize

Especifica el tamaño, en bytes, del búfer al que apunta pszBuffer.

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor	Significado
ERROR_BUFFER_OVERFLOW	El búfer al que apunta pszBuffer no es lo suficientemente grande como para contener el nombre guid devuelto.
ERROR_INVALID_PARAMETER	Uno de los parámetros siguientes hMprConfig, pszGuidName o pszBuffer es NULL.
ERROR_NOT_FOUND	No se encontró ningún nombre GUID que corresponda al nombre descriptivo especificado.

Para obtener más información, vea Avoiding Buffer Overruns(Evitar saturaciones del búfer).

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll