INetFwPolicy::GetProfileByType-Methode (netfw.h)
[Die Windows-Firewall-API ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Für Windows Vista und höher wird die Verwendung der Windows-Firewall mit erweiterter Sicherheits-API empfohlen.]
Ruft das Profil des angeforderten Typs ab.
Syntax
HRESULT GetProfileByType(
[in] NET_FW_PROFILE_TYPE profileType,
[out, ref] INetFwProfile **profile
);
Parameter
[in] profileType
Profiltyp aus NET_FW_PROFILE_TYPE.
[out, ref] profile
Abgerufenes Profil vom Typ INetFwProfile.
Abgerufenes Profil vom Typ INetFwProfile.
Rückgabewert
C++
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Fehler bei der Methode aufgrund eines ungültigen Zeigers. |
VB
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 aufgrund von Berechtigungsproblemen abgebrochen. |
|
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Fehler bei der Methode aufgrund eines ungültigen Zeigers. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | netfw.h |
| DLL | FirewallAPI.dll; Hnetcfg.dll unter Windows XP mit SP2 |