Функция GetNPPBlobFromUI
Функция GetNPPBlobFromUI выбирает регистровую карту.
Синтаксис
DWORD GetNPPBlobFromUI(
_In_ HWND hwnd,
_In_ HBLOB hFilterBlob,
_Out_ HBLOB *phBlob
);
Параметры
-
hwnd [in]
-
Дескриптор окна, в котором отображается диалоговое окно Выбор сети .
-
hFilterBlob [in]
-
Дескриптор фильтра BLOB , используемый для ограничения отображаемых сетевых карт.
-
phBlob [out]
-
Указатель на дескриптор БОЛЬШОго двоичного объекта, представляющего выбранный сетевой адаптер.
Возвращаемое значение
Если функция выполнена успешно (пользователь выбирает сетевой адаптер), возвращаемое значение NMERR_SUCCESS, а большой двоичный объект, на который указывает phBlob , заполняется.
Если пользователь не выбирает сетевой адаптер, возвращается значение NMERR_NO_NPP_SELECTED.
Если функция завершается неудачно, возвращается другое значение NMERR.
Комментарии
При вызове монитор сети отображает диалоговое окно Выбор сети , с помощью которого можно выбрать сетевую карту. Большой двоичный объект NPP, представляющий сетевой адаптер, возвращается вызывающему приложению.
Если большой двоичный объект с именем hFilterBlob является специальным BLOB-объектом, средство поиска попытается обработать его. Примером может быть вызов, который ранее возвращал специальный BLOB-объект из удаленной NPP. Приложение вставляет необходимый тег MACHINE_NAME. В этом случае средство поиска передает этот большой двоичный объект удаленному NPP, который затем возвращает таблицу больших двоичных объектов NPP, представляющих запрошенный компьютер. Эти удаленные большие двоичные объекты NPP будут отображаться в диалоговом окне.
Вызывающий объект должен вызвать функцию DestroyBlob , которая уничтожает возвращенный BLOB-объект, когда он больше не требуется.
Дополнительные сведения | См. |
---|---|
Три способа выбора сетевых адаптеров | Выбор сетевой карты |
Указание фильтра BLOB | Указание большого двоичного объекта фильтра |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|