NCM _ GETADDRESS-Nachricht
Gibt an, ob eine Netzwerkadresse einem angegebenen Typ und Format entspricht.
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
Parameter
-
wParam
- Muss Null sein.
-
pv [ in, out]
- Ein Zeiger auf eine NC_ADDRESS-Struktur, um Netzwerkadresseninformationen in analysierter Form zu empfangen, wenn das Adressformat und der Typ in dem durch *hwnd* angegebenen Steuerelement überprüft werden. Die aufrufende Anwendung ist für die Zuweisung des Arbeitsspeichers für diese Struktur verantwortlich.
Rückgabewert
Gibt einen der folgenden Werte vom Typ HRESULT zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die aufrufende Anwendung konnte keine NC _ ADDRESS-Struktur zuordnen. |
|
Der Out-Puffer ist zu klein, um die analysierte Netzwerkadresse zu halten. |
|
Die Netzwerkadressenzeichenfolge ist nicht vom angegebenen Typ. |
|
Der Vorgang wurde durchgeführt. |
|
Es gibt keine Adresse im Netzwerkadressen-Steuerelement, die überprüft werden soll. |
Bemerkungen
Verwenden Sie die NCM _ GETADDRESS-Nachricht, um eine Netzwerkadresse in einem Netzwerkadressen-Steuerelement anhand einer voreingestellten Netzwerkadressentypmaske zu überprüfen. Verwenden Sie zum Instanziieren die in Shellapi.h definierte Klasse msctls _ netaddress. Rufen Sie InitNetworkAddressControl zur Laufzeit auf, bevor Sie diese Nachricht senden. Dadurch wird die allgemeine Steuerelementbibliothek initialisiert, die das Netzwerkadressensteuerelemente enthält.
Diese Meldung ruft die Netzwerkadressenzeichenfolge aus einem Netzwerkadressen-Steuerelement ab, analysiert die Zeichenfolge und überprüft, ob die Zeichenfolge mit einer Netzwerkadressentypmaske entspricht. Wenn die Zeichenfolge der Maske entspricht, gibt die Nachricht S OK zurück und gibt die Zeichenfolge in analysierter Form an die aufrufende Anwendung (einschließlich Portnummer, Präfixlänge und andere Adressinformationen) zurück. Dabei wird die _ NC _ ADDRESS-Struktur verwendet, auf die pv zeigt. Diese Meldung gibt E INVALIDARG zurück, wenn die aufrufende Anwendung die Struktur nicht zuordnen kann, auf _ die pv zeigt.
Darstellungen der IP-Adressversionen 4 und 6 (v4/v6) für Dienste und Netzwerke sowie benannte Internetadressen und Dienste im DNS-Format (Domain Name System) werden analysiert. Wenn die Netzwerkadressenzeichenfolge einen benannten Hostnamen (DNS) oder Dienst darstellt, ist der im PrefixLength-Member von NC _ ADDRESS zurückgegebene Wert 0 (null).
Legen Sie die Netzwerkadressentypmaske mithilfe der NCM _ SETALLOWTYPE-Nachricht fest, bevor Sie das NCM _ GETADDRESS-Makro senden.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|