Função GetNPPBlobFromUI
A função GetNPPBlobFromUI seleciona uma NIC de registro.
Sintaxe
DWORD GetNPPBlobFromUI(
_In_ HWND hwnd,
_In_ HBLOB hFilterBlob,
_Out_ HBLOB *phBlob
);
Parâmetros
-
hwnd [in]
-
Um identificador para uma janela que exibe a caixa de diálogo Selecionar uma rede .
-
hFilterBlob [in]
-
Um identificador para um BLOB de filtro usado para limitar quais NICs são exibidas.
-
phBlob [out]
-
Um ponteiro para o identificador do BLOB que representa a NIC selecionada.
Valor retornado
Se a função for bem-sucedida (o usuário selecionar uma NIC), o valor retornado será NMERR_SUCCESS e o BLOB para o qual phBlob aponta será preenchido.
Se o usuário não selecionar uma NIC, o valor retornado será NMERR_NO_NPP_SELECTED.
Se a função não for bem-sucedida, o valor retornado será outro valor NMERR.
Comentários
Quando chamado, o Monitor de Rede exibe a caixa de diálogo Selecionar uma rede , que você pode usar para selecionar uma NIC. O BLOB do NPP que representa a NIC é retornado ao aplicativo de chamada.
Se o BLOB nomeado por hFilterBlob for um BLOB especial, o localizador tentará processá-lo. Um exemplo seria uma chamada que anteriormente havia retornado um BLOB especial do NPP remoto. O aplicativo inseriu a marca necessária, MACHINE_NAME. Nessa situação, o localizador passaria esse BLOB para o NPP remoto, que retornaria uma tabela de BLOBs NPP que representam o computador solicitado. Esses BLOBs NPP remotos apareceriam na caixa de diálogo.
O chamador deve chamar a função DestroyBlob , que destrói o BLOB retornado quando ele não é mais necessário.
| Para saber mais sobre | Consulte |
|---|---|
| Três maneiras de selecionar NICs | Selecionando uma placa de adaptador de rede |
| Especificando um BLOB de filtro | Especificando um BLOB de Filtro |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|