NetAddr_GetAddress Makro (shellapi.h)

  • Artikel

Gibt an, ob eine Netzwerkadresse einem angegebenen Typ und Format entspricht.

Syntax

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

Parameter

hwnd

Ein Handle für das Netzwerkadressensteuerelement, das die zu überprüfende Adresse enthält.

[in, out] pv

Ein Zeiger auf eine NC_ADDRESS Struktur zum Empfangen von Netzwerkadresseninformationen in analysierter Form, wenn das Adressformat und der Typ in dem von hwnd angegebenen Steuerelement überprüft werden. Die aufrufende Anwendung ist für die Zuweisung des Arbeitsspeichers für diese Struktur verantwortlich.

Rückgabewert

Keine

Bemerkungen

Verwenden Sie das Makro NetAddr_GetAddress , 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 dieses Makro aufrufen. Dadurch wird die allgemeine Steuerelementbibliothek initialisiert, die das Netzwerkadressensteuerelement enthält.

Dieses Makro 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 Funktion 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. Dieses Makro 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 des makros NetAddr_SetAllowType fest, bevor Sie das makro NetAddr_GetAddress aufrufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h

Weitere Informationen

NetAddr_GetAllowType