Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CNetAddressCtrl klasse vertegenwoordigt het netwerkadresbeheer, dat u kunt gebruiken om de indeling van IPv4, IPv6 en benoemde DNS-adressen in te voeren en te valideren.
Syntaxis
class CNetAddressCtrl : public CEdit
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | Maakt een CNetAddressCtrl object. |
Openbare methoden
| Naam | Description |
|---|---|
| CNetAddressCtrl::Create | Hiermee maakt u een netwerkadresbeheer met opgegeven stijlen en koppelt u dit aan het huidige CNetAddressCtrl object. |
| CNetAddressCtrl::CreateEx | Hiermee maakt u een netwerkadresbeheer met opgegeven uitgebreide stijlen en koppelt u dit aan het huidige CNetAddressCtrl object. |
| CNetAddressCtrl::D isplayErrorTip | Geeft een foutballoninfo weer wanneer de gebruiker een niet-ondersteund netwerkadres invoert in het huidige netwerkadresbeheer. |
| CNetAddressCtrl::GetAddress | Hiermee wordt een gevalideerde en geparseerde weergave opgehaald van het netwerkadres dat is gekoppeld aan het huidige netwerkadresbeheer. |
| CNetAddressCtrl::GetAllowType | Hiermee wordt het type netwerkadres opgehaald dat door het huidige netwerkadresbeheer kan worden ondersteund. |
| CNetAddressCtrl::SetAllowType | Hiermee stelt u het type netwerkadres in dat door het huidige netwerkadresbeheer kan worden ondersteund. |
Opmerkingen
Het netwerkadresbesturingselement controleert of de notatie van het adres dat de gebruiker invoert juist is. Het besturingselement maakt geen verbinding met het netwerkadres. De methode CNetAddressCtrl::SetAllowType specificeert een of meer typen adressen die de methode CNetAddressCtrl::GetAddress kan parseren en verifiëren. Een adres kan de vorm hebben van een IPv4-, IPv6- of benoemd adres voor een server, netwerk, host of broadcast-berichtbestemming. Als de indeling van het adres onjuist is, kunt u de methode CNetAddressCtrl::D isplayErrorTip gebruiken om een infotipberichtvak weer te geven dat grafisch verwijst naar het tekstvak van het netwerkadresbesturingselement en een vooraf gedefinieerd foutbericht weergeeft.
De CNetAddressCtrl klasse is afgeleid van de CEdit-klasse . Daarom biedt het netwerkadresbeheer toegang tot alle Windows-besturingselementberichten voor bewerken.
In de volgende afbeelding ziet u een dialoogvenster met een netwerkadresbeheer. Het tekstvak (1) voor het netwerkadresbeheer bevat een ongeldig netwerkadres. Het infotipbericht (2) wordt weergegeven als het netwerkadres ongeldig is.
Voorbeelden
Het volgende codevoorbeeld is een gedeelte van een dialoogvenster waarmee een netwerkadres wordt gevalideerd. De gebeurtenis-handlers voor drie keuzerondjes geven aan dat het netwerkadres een van de drie adrestypen kan zijn. De gebruiker voert een adres in het tekstvak van het netwerkbeheer in en drukt vervolgens op een knop om het adres te valideren. Als het adres geldig is, wordt er een geslaagd bericht weergegeven; anders wordt het vooraf gedefinieerde infotip-foutbericht weergegeven.
void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio1()
{
m_netAddr.SetAllowType(NET_STRING_IPV4_ADDRESS);
}
void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio2()
{
m_netAddr.SetAllowType(NET_STRING_IPV6_ADDRESS);
}
void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio3()
{
m_netAddr.SetAllowType(NET_STRING_NAMED_ADDRESS);
}
void CCNetAddressCtrl_s1Dlg::OnBnClickedButton1()
{
m_na.pAddrInfo = &m_nai;
HRESULT rslt = m_netAddr.GetAddress(&m_na);
if (rslt != S_OK)
m_netAddr.DisplayErrorTip();
else
{
MessageBox(
_T("Success!"), _T("Validation Results"));
}
In het volgende codevoorbeeld uit het dialoogvensterkopbestand worden de variabelen NC_ADDRESS en NET_ADDRESS_INFO gedefinieerd die vereist zijn voor de methode CNetAddressCtrl::GetAddress .
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
Overnamehiërarchie
CNetAddressCtrl
Requirements
Koptekst: afxcmn.h
Deze klasse wordt ondersteund in Windows Vista en hoger.
Aanvullende vereisten voor deze klasse worden beschreven in buildvereisten voor algemene besturingselementen voor Windows Vista.
CNetAddressCtrl::CNetAddressCtrl
Maakt een CNetAddressCtrl object.
CNetAddressCtrl();
Opmerkingen
Gebruik de methode CNetAddressCtrl::Create of CNetAddressCtrl::CreateEx om een netwerkbeheer te maken en deze aan het CNetAddressCtrl object te koppelen.
CNetAddressCtrl::Create
Hiermee maakt u een netwerkadresbeheer met opgegeven stijlen en koppelt u dit aan het huidige CNetAddressCtrl object.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameterwaarden
dwStyle-
[in] Een bitsgewijze combinatie van stijlen die op het besturingselement moeten worden toegepast. Zie Stijlen bewerken voor meer informatie.
Rect
[in] Een verwijzing naar een RECT-structuur die de positie en grootte van het besturingselement bevat.
pParentWnd
[in] Een niet-null-aanwijzer naar een CWnd-object dat het bovenliggende venster van het besturingselement is.
nID-
[in] De id van het besturingselement.
Retourwaarde
WAAR als deze methode is geslaagd; anders, ONWAAR.
CNetAddressCtrl::CreateEx
Hiermee maakt u een netwerkadresbeheer met opgegeven uitgebreide stijlen en koppelt u dit aan het huidige CNetAddressCtrl object.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameterwaarden
dwExStyle
[in] Een bitsgewijze combinatie (OR) van uitgebreide stijlen die op het besturingselement moeten worden toegepast. Zie de dwExStyle-parameter van de functie CreateWindowEx voor meer informatie.
dwStyle-
[in] Een bitwise combinatie (OR) van stijlen die op het besturingselement moeten worden toegepast. Zie Stijlen bewerken voor meer informatie.
Rect
[in] Een verwijzing naar een RECT-structuur die de positie en grootte van het besturingselement bevat.
pParentWnd
[in] Een niet-null-aanwijzer naar een CWnd-object dat het bovenliggende venster van het besturingselement is.
nID-
[in] De id van het besturingselement.
Retourwaarde
WAAR als deze methode is geslaagd; anders, ONWAAR.
CNetAddressCtrl::D isplayErrorTip
Geeft een foutbericht weer in de ballontip die is gekoppeld aan het huidige netwerkadresbeheer.
HRESULT DisplayErrorTip();
Retourwaarde
De waarde S_OK als deze methode is geslaagd, anders een foutcode.
Opmerkingen
Gebruik de methode CNetAddressCtrl::SetAllowType om de typen adressen op te geven die door het huidige netwerkadresbeheer kunnen worden ondersteund. Gebruik de methode CNetAddressCtrl::GetAddress om het netwerkadres te valideren en parseren dat de gebruiker invoert. Gebruik de methode CNetAddressCtrl::D isplayErrorTip om een foutberichtinfo weer te geven als de CNetAddressCtrl::GetAddress-methode mislukt is.
Dit bericht roept de NetAddr_DisplayErrorTip macro aan, die wordt beschreven in de Windows SDK. Met deze macro wordt het NCM_DISPLAYERRORTIP bericht verzonden.
CNetAddressCtrl::GetAddress
Hiermee wordt een gevalideerde en geparseerde weergave opgehaald van het netwerkadres dat is gekoppeld aan het huidige netwerkadresbeheer.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
Parameterwaarden
pAddress
[in, uit] Wijs een NC_ADDRESS structuur aan. Stel het lid pAddrInfo van deze structuur in op het adres van een NET_ADDRESS_INFO structuur voordat u de Methode GetAddress aanroept.
Retourwaarde
De waarde S_OK als deze methode is geslaagd; anders een COM-foutcode. Zie de sectie Retourwaarde van de macro NetAddr_GetAddress voor meer informatie over de mogelijke foutcodes.
Opmerkingen
Als deze methode is geslaagd, bevat de NET_ADDRESS_INFO structuur aanvullende informatie over het netwerkadres.
Gebruik de methode CNetAddressCtrl::SetAllowType om de typen adressen op te geven die het huidige netwerkadresbeheer kan ondersteunen. Gebruik de methode CNetAddressCtrl::GetAddress om het netwerkadres te valideren en parseren dat de gebruiker invoert. Gebruik de methode CNetAddressCtrl::D isplayErrorTip om een foutberichtinfo weer te geven als de CNetAddressCtrl::GetAddress-methode mislukt is.
Met deze methode wordt de NetAddr_GetAddress macro aangeroepen, die wordt beschreven in de Windows SDK. Met deze macro wordt het NCM_GETADDRESS bericht verzonden.
CNetAddressCtrl::GetAllowType
Hiermee wordt het type netwerkadres opgehaald dat door het huidige netwerkadresbeheer kan worden ondersteund.
DWORD GetAllowType() const;
Retourwaarde
Een bitsgewijze combinatie (OR) van vlaggen die de typen adressen aangeeft die door het netwerkadresbeheer kunnen worden ondersteund. Zie NET_STRING voor meer informatie.
Opmerkingen
Dit bericht roept de NetAddr_GetAllowType macro aan, die wordt beschreven in de Windows SDK. Met deze macro wordt het NCM_GETALLOWTYPE bericht verzonden.
CNetAddressCtrl::SetAllowType
Hiermee stelt u het type netwerkadres in dat door het huidige netwerkadresbeheer kan worden ondersteund.
HRESULT SetAllowType(DWORD dwAddrMask);
Parameterwaarden
dwAddrMask
[in] Een bitsgewijze combinatie (OR) van vlaggen die de typen adressen aangeeft die door het netwerkadresbeheer kunnen worden ondersteund. Zie NET_STRING voor meer informatie.
Retourwaarde
S_OK als deze methode is geslaagd; anders een COM-foutcode.
Opmerkingen
Gebruik de methode CNetAddressCtrl::SetAllowType om de typen adressen op te geven die door het huidige netwerkadresbeheer kunnen worden ondersteund. Gebruik de methode CNetAddressCtrl::GetAddress om het netwerkadres te valideren en parseren dat de gebruiker invoert. Gebruik de methode CNetAddressCtrl::D isplayErrorTip om een foutberichtinfo weer te geven als de CNetAddressCtrl::GetAddress-methode mislukt is.
Dit bericht roept de NetAddr_SetAllowType macro aan, die wordt beschreven in de Windows SDK. Met deze macro wordt het NCM_SETALLOWTYPE bericht verzonden.