Поделиться через


Функция MprConfigGetGuidName (mprapi.h)

Функция MprConfigGetGuidName возвращает guid-имя для интерфейса, соответствующего указанному понятному имени.

Синтаксис

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

Параметры

[in] hMprConfig

Обработка конфигурации маршрутизатора. Получите этот дескриптор, вызвав MprConfigServerConnect.

[in] pszFriendlyName

Указатель на строку Юникода, указывающую понятное имя интерфейса.

[out] pszBuffer

Указатель на буфер, получающий guid-имя для интерфейса.

[in] dwBufferSize

Указывает размер (в байтах) буфера, на который указывает pszBuffer.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение Значение
ERROR_BUFFER_OVERFLOW
Буфер, на который указывает pszBuffer , недостаточно велик для хранения возвращенного имени GUID.
ERROR_INVALID_PARAMETER
По крайней мере один из параметров hMprConfig, pszFriendlyName или pszBuffer имеет значение NULL.
ERROR_NOT_FOUND
Не найдено имя GUID, соответствующее указанному понятному имени.
 
 

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mprapi.h
Библиотека Mprapi.lib
DLL Mprapi.dll

См. также раздел

MprConfigGetFriendlyName

MprConfigServerConnect

Функции конфигурации маршрутизатора

Справочник по управлению маршрутизаторами