NCM_GETADDRESS mensagem
Indica se um endereço de rede está em conformidade com um tipo e um formato especificados.
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
Parâmetros
-
wParam
- Deve ser zero.
-
pv [in, out]
- Um ponteiro para uma estrutura NC_ADDRESS para receber informações de endereço de rede no formato analisado, se o formato de endereço e o tipo no controle especificado por *hwnd* forem validados. O aplicativo de chamada é responsável por alocar a memória para essa estrutura.
Valor retornado
Retorna um dos seguintes valores do tipo HRESULT.
| Código de retorno | Descrição |
|---|---|
|
O aplicativo de chamada falhou ao alocar uma estrutura NC_ADDRESS . |
|
O buffer de saída é muito pequeno para conter o endereço de rede analisado. |
|
A cadeia de caracteres de endereço de rede não é de nenhum tipo especificado. |
|
A operação foi bem-sucedida. |
|
Não há nenhum endereço no controle de endereço de rede a ser validado. |
Comentários
Use a mensagem NCM_GETADDRESS para validar um endereço de rede em um controle de endereço de rede em relação a uma máscara de tipo de endereço de rede predefinida. Para criar uma instância, use a classe msctls_netaddress definida em Shellapi.h. Chame InitNetworkAddressControl em tempo de execução antes de enviar essa mensagem. Isso inicializa a biblioteca de controles comuns que contém o controle de endereço de rede.
Essa mensagem obtém a cadeia de caracteres de endereço de rede de um controle de endereço de rede, analisa a cadeia de caracteres e verifica se a cadeia de caracteres corresponde a uma máscara de tipo de endereço de rede. Se a cadeia de caracteres corresponder à máscara, a mensagem retornará S_OK e retornará a cadeia de caracteres em forma analisada para o aplicativo de chamada (incluindo o número da porta, o comprimento do prefixo e outras informações de endereço), usando a estrutura NC_ADDRESS apontada por pv. Essa mensagem retornará E_INVALIDARG se o aplicativo de chamada não conseguir alocar a estrutura apontada por pv.
Representações de endereço IP (Protocolo IP) versões 4 e 6 (v4/v6) para serviços e redes, bem como endereços e serviços de Internet nomeados usando o formato DNS (Sistema de Nomes de Domínio) são analisados. Se a cadeia de caracteres de endereço de rede representar um DNS (nome de host) ou serviço nomeado, o valor retornado no membro PrefixLength de NC_ADDRESS será zero.
Defina a máscara de tipo de endereço de rede usando a mensagem NCM_SETALLOWTYPE antes de enviar a macro NCM_GETADDRESS .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também