INetSharingConfiguration::get_SharingEnabled-Methode (netcon.h)

Artikel
08/25/2023

[Die Internetverbindungsfirewall kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Windows-Firewall-API.]

Die get_SharingEnabled-Methode bestimmt, ob die Freigabe für diese Verbindung aktiviert ist.

Syntax

HRESULT get_SharingEnabled(
  [out] VARIANT_BOOL *pbEnabled
);

Parameter

[out] pbEnabled

Zeiger auf eine VARIANT_BOOL Variable, die bei erfolgreicher Rückgabe angibt, ob die Freigabe für diese Verbindung aktiviert ist. Wenn die Freigabe aktiviert ist, ist dieser Wert TRUE. Andernfalls ist es FALSE.

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
E_ABORT	Der Vorgang wurde abgebrochen.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Einer der Parameter ist ungültig.
E_NOINTERFACE	Eine angegebene Schnittstelle wird nicht unterstützt.
E_NOTIMPL	Eine angegebene Methode wird nicht implementiert.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Ein als Parameter übergebener Zeiger ist ungültig.
E_UNEXPECTED	Fehler bei der Methode aus unbekannten Gründen.

Hinweise

Verwenden Sie INetSharingManager::get_SharingInstalled, um zu ermitteln, ob die Verbindungsfreigabe unter dem derzeit installierten Betriebssystem unterstützt wird.

Verwenden Sie die INetSharingManager::get_INetSharingConfigurationForINetConnection-Methode , um eine INetSharingConfiguration-Schnittstelle für eine bestimmte Verbindung abzurufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	netcon.h
DLL	Hnetcfg.dll