INetConnection::GetProperties-Methode (netcon.h)
[Die Internetverbindungsfirewall kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Windows-Firewall-API.]
Die GetProperties-Methode ruft eine Struktur ab, die die Eigenschaften für diese Netzwerkverbindung enthält.
Syntax
HRESULT GetProperties(
[out] NETCON_PROPERTIES **ppProps
);
Parameter
[out] ppProps
Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe auf eine NETCON_PROPERTIES-Struktur verweist, die die Eigenschaften für diese Netzwerkverbindung enthält.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.
Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde abgebrochen. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Einer der Parameter ist ungültig. |
|
Eine angegebene Schnittstelle wird nicht unterstützt. |
|
Eine angegebene Methode wird nicht implementiert. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Ein als Parameter übergebener Zeiger ist ungültig. |
|
Fehler bei der Methode aus unbekannten Gründen. |
Hinweise
Die aufrufende Anwendung sollte den von getProperties zurückgegebenen NETCON_PROPERTIES-Struktur belegten Arbeitsspeicher freigeben. Geben Sie den Arbeitsspeicher frei, indem Sie die NcFreeNetconProperties-Funktion aufrufen. Diese Funktion ist in NetCon.h definiert und wird von NetShell.dll exportiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | netcon.h |
| DLL | Hnetcfg.dll |
Weitere Informationen
Internetverbindungsfreigabe und Firewallschnittstellen für Internetverbindung
Referenz zur Freigabe von Internetverbindung und Internetverbindungsfirewall