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
E _ INVALIDARG
Die aufrufende Anwendung konnte keine NC _ ADDRESS-Struktur zuordnen.
FEHLER: _ NICHT GENÜGEND _ PUFFER
Der Out-Puffer ist zu klein, um die analysierte Netzwerkadresse zu halten.
FEHLER _ UNGÜLTIGER _ PARAMETER
Die Netzwerkadressenzeichenfolge ist nicht vom angegebenen Typ.
FEHLER _ ERFOLGREICH
Der Vorgang wurde durchgeführt.
S _ FALSE
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
Shellapi.h

Weitere Informationen

NCM _ GETALLOWTYPE

NetAddr _ GetAddress