NCM_GETADDRESS Nachricht

Artikel
06/13/2023

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 zum Empfangen von Netzwerkadresseninformationen in analysierter Form, wenn das Adressformat und der Typ in das von *hwnd* angegebene 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 eine NC_ADDRESS Struktur nicht zuordnen.
ERROR_INSUFFICIENT_BUFFER	Der Outpuffer ist zu klein, um die analysierte Netzwerkadresse zu speichern.
ERROR_INVALID_PARAMETER	Die Netzwerkadressenzeichenfolge hat keinen angegebenen Typ.
ERROR_SUCCESS	Der Vorgang wurde durchgeführt.
S_FALSE	Im Netzwerkadressensteuerelement ist keine Adresse vorhanden, die überprüft werden muss.

Bemerkungen

Verwenden Sie die NCM_GETADDRESS-Nachricht , um eine Netzwerkadresse in einem Netzwerkadressensteuerelement anhand einer voreingestellten Netzwerkadresstypmaske zu überprüfen. Verwenden Sie zum Instanziieren die Klasse msctls_netaddress , die in Shellapi.h definiert ist. Rufen Sie InitNetworkAddressControl zur Laufzeit auf, bevor Sie diese Nachricht senden. Dadurch wird die allgemeine Steuerelementbibliothek initialisiert, die das Netzwerkadressensteuerelement enthält.

Diese Nachricht ruft die Netzwerkadressenzeichenfolge aus einem Netzwerkadresssteuerelement ab, analysiert die Zeichenfolge und überprüft, ob die Zeichenfolge einer Netzwerkadresstypmaske entspricht. Wenn die Zeichenfolge mit der Maske übereinstimmt, gibt die Nachricht S_OK zurück und gibt die Zeichenfolge in analysierter Form an die aufrufende Anwendung zurück (einschließlich der Portnummer, präfixlänge und anderer Adressinformationen), wobei die NC_ADDRESS Struktur verwendet wird, auf die von pv verwiesen wird. Diese Nachricht gibt E_INVALIDARG zurück, wenn die aufrufende Anwendung die struktur nicht zuordnen kann, auf die von pv verwiesen wird.

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 einen Dienst darstellt, ist der im PrefixLength-Member von NC_ADDRESS zurückgegebene Wert 0.

Legen Sie die Netzwerkadresstypmaske mithilfe der NCM_SETALLOWTYPE-Nachricht fest, bevor Sie das NCM_GETADDRESS-Makro senden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Shellapi.h

Siehe auch

NCM_GETALLOWTYPE
NetAddr_GetAddress

Share via