NetAddr_GetAddress Makro (shellapi.h)

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

Syntax

HRESULT NetAddr_GetAddress(
             HWND hwnd,
  [in, out]  LPARAM pv
);

Die Parameter

hwnd

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

[in, out] pv

Ein Zeiger auf eine NC_ADDRESS Struktur, um Netzwerkadresseninformationen in analysierter Form zu empfangen, wenn das Adressformat und der Typ in das durch hwnd angegebene Steuerelement überprüft werden. Die aufrufende Anwendung ist für die Zuordnung des Speichers für diese Struktur verantwortlich.

Rückgabewert

Typ: HRESULT-

Gibt einen der folgenden Werte vom Typ HRESULT zurück:

• E_INVALIDARG – Die aufrufende Anwendung konnte keine NC_ADDRESS Struktur zuordnen.
• ERROR_INSUFFICIENT_BUFFER – Der Ausgabepuffer ist zu klein, um die analysierte Netzwerkadresse aufzunehmen.
• ERROR_INVALID_PARAMETER – Die Netzwerkadressenzeichenfolge weist keinen typspezifischen Wert auf.
• ERROR_SUCCESS – Der Vorgang war erfolgreich.
• S_FALSE – Es gibt keine Adresse im Netzwerkadresssteuerelement, die überprüft werden soll.

Bemerkungen

Verwenden Sie das makro NetAddr_GetAddress , um eine Netzwerkadresse in einem Netzwerkadresssteuerelement anhand eines vordefinierten Netzwerkadressentypformats zu überprüfen. Verwenden Sie zum Instanziieren die Klasse msctls_netaddress in Shellapi.h definiert. Rufen Sie InitNetworkAddressControl zur Laufzeit auf, bevor Sie dieses Makro aufrufen. Dadurch wird die allgemeine Steuerelementbibliothek initialisiert, die das Netzwerkadresssteuerelement enthält.

Dieses Makro ruft die Netzwerkadressenzeichenfolge aus einem Netzwerkadresssteuerelement ab, analysiert die Zeichenfolge und überprüft, ob die Zeichenfolge einem Netzwerkadressentypformat 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, der Präfixlänge und anderer Adressinformationen), wobei die NC_ADDRESS Struktur verwendet wird, auf die bw verweist. Dieses Makro gibt E_INVALIDARG zurück, wenn die aufrufende Anwendung die struktur, auf die durch Pv verweist, nicht zuweist.

Darstellungen der IP-Adressversionen 4 und 6 (v4/v6) für Dienste und Netzwerke sowie benannte Internetadressen und -dienste mit dem DNS-Format (Domain Name System) werden analysiert. Wenn die Netzwerkadressenzeichenfolge einen benannten Hostnamen (DNS) oder Dienst darstellt, ist der im PrefixLength-Element von NC_ADDRESS zurückgegebene Wert Null.

Legen Sie das Netzwerkadressentypformat mithilfe des makros NetAddr_SetAllowType fest, bevor Sie das makro NetAddr_GetAddress aufrufen.

Anforderungen

Siehe auch

NetAddr_GetAllowType