WlanIhvControl-Funktion (wlanapi.h)

Artikel
03/13/2024

Die WlanIhvControl-Funktion bietet einen Mechanismus zur Steuerung von WLAN-Treibern oder -Diensten durch unabhängige Hardwarehersteller (IHV).

Syntax

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Die GUID der Schnittstelle.

[in] Type

Eine WLAN_IHV_CONTROL_TYPE-Struktur , die den Typ der Software angibt, die von der IHV-Steuerungsfunktion umgangen wird.

[in] dwInBufferSize

Die Größe des Eingabepuffers in Bytes.

[in] pInBuffer

Ein generischer Puffer für Treiber- oder Dienstschnittstelleneingaben.

[in] dwOutBufferSize

Die Größe des Ausgabepuffers in Bytes.

[in, out, optional] pOutBuffer

Ein generischer Puffer für die Treiber- oder Dienstschnittstellenausgabe.

[out] pdwBytesReturned

Die Anzahl der zurückgegebenen Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um diesen Vorgang auszuführen. Beim Aufruf ruft WlanIhvControl die daCL (Discretionary Access Control List) ab, die mit dem wlan_secure_ihv_control-Objekt gespeichert ist. Wenn die DACL keinen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der WLAN_WRITE_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanIhvControlERROR_ACCESS_DENIED zurück.
ERROR_INVALID_PARAMETER	hClientHandle ist NULL oder ungültig, pInterfaceGuid ist NULL oder pdwBytesReturned ist NULL.
ERROR_INVALID_HANDLE	Das Handle hClientHandle wurde in der Handletabelle nicht gefunden.
ERROR_NOT_SUPPORTED	Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP mit SP3 oder einer WLAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS	Verschiedene Fehlercodes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h (wlanapi.h einschließen)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll

Weitere Informationen

WLAN_IHV_CONTROL_TYPE

Freigeben über