macro NetAddr_GetAddress (shellapi.h)

Indica se un indirizzo di rete è conforme a un tipo e formato specificato.

Sintassi

void NetAddr_GetAddress(
             hwnd,
  [in, out]  pv
);

Parametri

hwnd

Handle per il controllo dell'indirizzo di rete che contiene l'indirizzo da convalidare.

[in, out] pv

Puntatore a una struttura NC_ADDRESS per ricevere le informazioni sull'indirizzo di rete nel modulo analizzato, se il formato dell'indirizzo e il tipo nel controllo specificato da hwnd vengono convalidati. L'applicazione chiamante è responsabile dell'allocazione della memoria per questa struttura.

Valore restituito

nessuno

Osservazioni

Usare la macro NetAddr_GetAddress per convalidare un indirizzo di rete in un controllo dell'indirizzo di rete rispetto a una maschera di tipo di indirizzo di rete predefinita. Per creare un'istanza, usare la classe msctls_netaddress definita in Shellapi.h. Chiamare InitNetworkAddressControl in fase di esecuzione prima di chiamare questa macro. In questo modo viene inizializzata la libreria dei controlli comuni che contiene il controllo dell'indirizzo di rete.

Questa macro ottiene la stringa di indirizzo di rete da un controllo indirizzo di rete, analizza la stringa e verifica se la stringa corrisponde a una maschera di tipo di indirizzo di rete. Se la stringa corrisponde alla maschera, la funzione restituisce S_OK e restituisce la stringa nella forma analizzata all'applicazione chiamante (incluso il numero di porta, la lunghezza del prefisso e altre informazioni sull'indirizzo), usando la struttura NC_ADDRESS puntata da pv. Questa macro restituisce E_INVALIDARG se l'applicazione chiamante non riesce ad allocare la struttura puntata da pv.

Le rappresentazioni degli indirizzi IP (Internet Protocol) 4 e 6 (v4/v6) per i servizi e le reti, nonché gli indirizzi Internet e i servizi denominati tramite il formato DNS (Domain Name System) vengono analizzate. Se la stringa di indirizzo di rete rappresenta un nome host denominato (DNS) o un servizio, il valore restituito nel membro PrefixLength di NC_ADDRESS è zero.

Impostare la maschera di tipo di indirizzo di rete usando la macro NetAddr_SetAllowType prima di chiamare la macro NetAddr_GetAddress .

Requisiti

Vedi anche

NetAddr_GetAllowType