WlanIhvControl-Funktion (wlanapi.h)

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