WCN_ATTRIBUTE_TYPE-Enumeration (wcntypes.h)

Die WCN_ATTRIBUTE_TYPE-Enumeration definiert die Attributpuffertypen, die für Wi-Fi Protected Setup definiert sind. Die Gesamtgröße, die von jedem Attributpuffer belegt wird, umfasst zusätzliche 4 Bytes (2 Byte ID, 2 Bytes Länge).

Syntax

typedef enum tagWCN_ATTRIBUTE_TYPE {
  WCN_TYPE_AP_CHANNEL = 0,
  WCN_TYPE_ASSOCIATION_STATE,
  WCN_TYPE_AUTHENTICATION_TYPE,
  WCN_TYPE_AUTHENTICATION_TYPE_FLAGS,
  WCN_TYPE_AUTHENTICATOR,
  WCN_TYPE_CONFIG_METHODS,
  WCN_TYPE_CONFIGURATION_ERROR,
  WCN_TYPE_CONFIRMATION_URL4,
  WCN_TYPE_CONFIRMATION_URL6,
  WCN_TYPE_CONNECTION_TYPE,
  WCN_TYPE_CONNECTION_TYPE_FLAGS,
  WCN_TYPE_CREDENTIAL,
  WCN_TYPE_DEVICE_NAME,
  WCN_TYPE_DEVICE_PASSWORD_ID,
  WCN_TYPE_E_HASH1,
  WCN_TYPE_E_HASH2,
  WCN_TYPE_E_SNONCE1,
  WCN_TYPE_E_SNONCE2,
  WCN_TYPE_ENCRYPTED_SETTINGS,
  WCN_TYPE_ENCRYPTION_TYPE,
  WCN_TYPE_ENCRYPTION_TYPE_FLAGS,
  WCN_TYPE_ENROLLEE_NONCE,
  WCN_TYPE_FEATURE_ID,
  WCN_TYPE_IDENTITY,
  WCN_TYPE_IDENTITY_PROOF,
  WCN_TYPE_KEY_WRAP_AUTHENTICATOR,
  WCN_TYPE_KEY_IDENTIFIER,
  WCN_TYPE_MAC_ADDRESS,
  WCN_TYPE_MANUFACTURER,
  WCN_TYPE_MESSAGE_TYPE,
  WCN_TYPE_MODEL_NAME,
  WCN_TYPE_MODEL_NUMBER,
  WCN_TYPE_NETWORK_INDEX,
  WCN_TYPE_NETWORK_KEY,
  WCN_TYPE_NETWORK_KEY_INDEX,
  WCN_TYPE_NEW_DEVICE_NAME,
  WCN_TYPE_NEW_PASSWORD,
  WCN_TYPE_OOB_DEVICE_PASSWORD,
  WCN_TYPE_OS_VERSION,
  WCN_TYPE_POWER_LEVEL,
  WCN_TYPE_PSK_CURRENT,
  WCN_TYPE_PSK_MAX,
  WCN_TYPE_PUBLIC_KEY,
  WCN_TYPE_RADIO_ENABLED,
  WCN_TYPE_REBOOT,
  WCN_TYPE_REGISTRAR_CURRENT,
  WCN_TYPE_REGISTRAR_ESTABLISHED,
  WCN_TYPE_REGISTRAR_LIST,
  WCN_TYPE_REGISTRAR_MAX,
  WCN_TYPE_REGISTRAR_NONCE,
  WCN_TYPE_REQUEST_TYPE,
  WCN_TYPE_RESPONSE_TYPE,
  WCN_TYPE_RF_BANDS,
  WCN_TYPE_R_HASH1,
  WCN_TYPE_R_HASH2,
  WCN_TYPE_R_SNONCE1,
  WCN_TYPE_R_SNONCE2,
  WCN_TYPE_SELECTED_REGISTRAR,
  WCN_TYPE_SERIAL_NUMBER,
  WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE,
  WCN_TYPE_SSID,
  WCN_TYPE_TOTAL_NETWORKS,
  WCN_TYPE_UUID_E,
  WCN_TYPE_UUID_R,
  WCN_TYPE_VENDOR_EXTENSION,
  WCN_TYPE_VERSION,
  WCN_TYPE_X_509_CERTIFICATE_REQUEST,
  WCN_TYPE_X_509_CERTIFICATE,
  WCN_TYPE_EAP_IDENTITY,
  WCN_TYPE_MESSAGE_COUNTER,
  WCN_TYPE_PUBLIC_KEY_HASH,
  WCN_TYPE_REKEY_KEY,
  WCN_TYPE_KEY_LIFETIME,
  WCN_TYPE_PERMITTED_CONFIG_METHODS,
  WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS,
  WCN_TYPE_PRIMARY_DEVICE_TYPE,
  WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST,
  WCN_TYPE_PORTABLE_DEVICE,
  WCN_TYPE_AP_SETUP_LOCKED,
  WCN_TYPE_APPLICATION_EXTENSION,
  WCN_TYPE_EAP_TYPE,
  WCN_TYPE_INITIALIZATION_VECTOR,
  WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY,
  WCN_TYPE_802_1X_ENABLED,
  WCN_TYPE_APPSESSIONKEY,
  WCN_TYPE_WEPTRANSMITKEY,
  WCN_TYPE_UUID,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY,
  WCN_TYPE_CURRENT_SSID,
  WCN_TYPE_BSSID,
  WCN_TYPE_DOT11_MAC_ADDRESS,
  WCN_TYPE_AUTHORIZED_MACS,
  WCN_TYPE_NETWORK_KEY_SHAREABLE,
  WCN_TYPE_REQUEST_TO_ENROLL,
  WCN_TYPE_REQUESTED_DEVICE_TYPE,
  WCN_TYPE_SETTINGS_DELAY_TIME,
  WCN_TYPE_VERSION2,
  WCN_TYPE_VENDOR_EXTENSION_WFA,
  WCN_NUM_ATTRIBUTE_TYPES
} WCN_ATTRIBUTE_TYPE;

Konstanten

WCN_TYPE_AP_CHANNEL Wert: 0 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Wert mit Daten ist, der den 802.11-Kanal angibt, den der Zugriffspunkt hosten wird.
WCN_TYPE_ASSOCIATION_STATE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Wert ist, der den durch WCN_VALUE_TYPE_ASSOCIATION_STATE definierten Zuordnungsstatus oder Konfigurationsinformationen enthält.
WCN_TYPE_AUTHENTICATION_TYPE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Wert ist, der einen durch WCN_VALUE_TYPE_AUTHENTICATION_TYPE definierten Authentifizierungstyp enthält.
WCN_TYPE_AUTHENTICATION_TYPE_FLAGS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Wert ist, der Daten enthält, die die Netzwerkauthentifizierungsfunktionen des Enrollee (Zugriffspunkt oder Station) angeben, indem ein Durch WCN_VALUE_TYPE_AUTHENTICATION_TYPE definierter Wert.
WCN_TYPE_AUTHENTICATOR Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der einen schlüsselierten Datenhash enthält. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_CONFIG_METHODS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode durch WCN_VALUE_TYPE_CONFIG_METHODS definierte Werte enthält, die die von der Registrierung oder Registrierungsstelle unterstützten Konfigurationsmethoden angeben. Darüber hinaus, Zugangspunkte und Stationen die UPnP-Verwaltungsschnittstelle unterstützen, muss auch dieses Attribut unterstützen, das wird verwendet, um die Konfigurationsmethoden zu steuern, die auf dem Zugriffspunkt aktiviert sind.
WCN_TYPE_CONFIGURATION_ERROR Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein durch WCN_VALUE_TYPE_CONFIGURATION_ERROR definierter Wert ist, der das Ergebnis des Geräts angibt, das versucht, sich selbst zu konfigurieren und dem WLAN zuzuordnen. Wenn eine Konfigurationssitzung mit dem Fehlercode WCN_E_CONNECTION_REJECTED fehlschlägt, kann jeder vom Remotegerät zurückgegebene Fehlercode durch Abfragen dieses Attributs abgerufen werden. Es ist wichtig zu beachten, dass einige Geräte WCN_VALUE_CE_NO_ERROR zurückgeben, auch wenn ein Fehler aufgetreten ist.
WCN_TYPE_CONFIRMATION_URL4 Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der Daten enthält, die die URL (IPv4-Adressbasis) darstellen, die von der Registrierungsstelle an den Registrierungsempfänger zur Verwendung in der Bestätigung bereitgestellt wird. sobald die Einstellungen erfolgreich angewendet wurden und das Netzwerk hinzugefügt wurde. Diese Konfiguration der Parameter ist für eine Registrierungsstelle optional, und er ist optional für den Registrierungsempfänger, um beiträge an die URL zu senden, wenn die Registrierungsstelle enthält es. Hinweis Ein Registrierter darf keine Verbindung mit einer Bestätigungs-URL herstellen, die sich in einem anderen Subnetz befindet.
WCN_TYPE_CONFIRMATION_URL6 Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der Daten enthält, die die URL (IPv6-Adressbasis) darstellen, die von der Registrierungsstelle für die Verwendung beim Bereitstellen einer Bestätigung bereitgestellt wird. sobald die Einstellungen erfolgreich angewendet wurden und das Netzwerk hinzugefügt wurde. Diese Konfiguration der Parameter ist für eine Registrierungsstelle optional, und er ist optional für den Registrierungsempfänger, um beiträge an die URL zu senden, wenn die Registrierungsstelle enthält es. Hinweis Der Registrierende darf keine Verbindung mit einer Bestätigungs-URL herstellen, die sich in einem anderen Subnetz befindet.
WCN_TYPE_CONNECTION_TYPE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen durch WCN_VALUE_TYPE_CONNECTION_TYPE definierten Wert enthält, der die Verbindungsfunktion des Enrollee angibt.
WCN_TYPE_CONNECTION_TYPE_FLAGS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen durch WCN_VALUE_TYPE_CONNECTION_TYPE definierten Wert enthält, der die Verbindungsfunktion des Enrollee angibt.
WCN_TYPE_CREDENTIAL Dieser zusammengesetzte Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode eine einzelne WLAN-Anmeldeinformation enthält. Es können entweder mehrere Anmeldeinformationsattribute für jeden Netzwerkschlüssel oder mehrere vorhanden sein. Netzwerkschlüssel in einem einzelnen Anmeldeinformationsattribut, das durch Wiederholen des Netzwerkschlüsselindexes und der Attribute erreicht wird, die Folgen Sie diesem. Im Allgemeinen sind mehrere Schlüssel in einer einzelnen Anmeldeinformation für eine einzelne SSID und mehrere Anmeldeinformationsattribute für Es sollten separate SSIDs verwendet werden. Die folgenden Attribute sind in jeder instance von Anmeldeinformationen enthalten: WCN_TYPE_AUTHENTICATION_TYPE WCN_TYPE_ENCRYPTION_TYPE WCN_TYPE_SSID WCN_TYPE_NETWORK_INDEX Wenn eine Anwendung die Netzwerkanmeldeinformationen mit der WLAN-API verwenden möchte, sollte sie IWCNDevice::GetNetworkProfile verwenden, um direkt ein kompatibles XML-Netzwerkprofil abzurufen.
WCN_TYPE_DEVICE_NAME Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der eine benutzerfreundliche Beschreibung des in UTF-8 codierten Geräts enthält. In der Regel die -Komponente wäre ein eindeutiger Bezeichner, der das Produkt auf eine Weise beschreibt, die für den Benutzer erkennbar ist.
WCN_TYPE_DEVICE_PASSWORD_ID Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen wert enthält, der durch den WCN VALUE TYPE DEVICE_PASSWORD_ID definiert wird, der zum Identifizieren eines Gerätekennworts verwendet wird.
WCN_TYPE_E_HASH1 Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode den HMAC-SHA-256-Hash der ersten Hälfte des Gerätekennworts und des ersten Geheimnisses des Registrierten enthält. Nonce. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_E_HASH2 Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode den HMAC-SHA-256-Hash der zweiten Hälfte des Gerätekennworts und die zweite der Registrierung enthält. Geheimnis-Nonce. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_E_SNONCE1 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode die erste Nonce enthält, die vom Enrollee mit der ersten Hälfte des Gerätekennworts verwendet wird. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_E_SNONCE2 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode die zweite Nonce enthält, die vom Enrollee mit der zweiten Hälfte des Gerätekennworts verwendet wird. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_ENCRYPTED_SETTINGS Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode einen Initialisierungsvektor (IV) gefolgt von einem Satz enthält. von verschlüsselten Wi-Fi Geschützten Setup-TLV-Attributen. Das letzte Attribut in der verschlüsselten Gruppe ist ein Schlüsselumbruch. Der Authentifikator wird gemäß dem in Abschnitt 6.5 beschriebenen Verfahren berechnet. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_ENCRYPTION_TYPE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen durch WCN_VALUE_TYPE_ENCRYPTION_TYPE definierten Wert für den Enrollee (AP oder) enthält. station) zu verwenden.
WCN_TYPE_ENCRYPTION_TYPE_FLAGS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen durch WCN_VALUE_TYPE_ENCRYPTION_TYPE definierten Wert für den Enrollee (AP oder) enthält. station) zu verwenden.
WCN_TYPE_ENROLLEE_NONCE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode einen zufällig generierten binärwert enthält, der vom Enrollee für erstellt wird. Setupvorgänge. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_FEATURE_ID Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode Daten enthält, die einen bestimmten Featurebuild für ein auf dem Gerät ausgeführtes Betriebssystem angeben. Das wichtigste Bit der 4-Byte-Ganzzahl ist reserviert und immer auf eins festgelegt.
WCN_TYPE_IDENTITY Reserviert. Darf nicht verwendet werden.
WCN_TYPE_IDENTITY_PROOF Reserviert. Darf nicht verwendet werden.
WCN_TYPE_KEY_WRAP_AUTHENTICATOR Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein 8-Byte-Puffer mit den ersten 64 Bits des HMAC-SHA-256 ist, der über die zu verschlüsselnden Daten berechnet wird. mit dem Schlüsselumbruchalgorithmus. Sie wird vor der Verschlüsselung am Ende von ConfigData angefügt. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_KEY_IDENTIFIER Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetAttribute-Methode ein 16-Byte-Puffer ist, der einen 128-Bit-Schlüsselbezeichner enthält. Wenn dieses Attribut unmittelbar vor verschlüsselten Daten steht oder Authenticator-Attribut, dann sollte der Schlüssel, der dem 128-Bit-Bezeichner entspricht, zum Entschlüsseln verwendet werden. oder überprüfen Sie das Feld Daten.
WCN_TYPE_MAC_ADDRESS Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein 6-Byte-Puffer ist, der den 48-Bit-Wert der MAC-Adresse enthält. Für Beispiel: 0x00 0x07 0xE9 0x4C 0xA8 0x1C. Diese Adresse wird vom Remotegerät bereitgestellt. Einige Access Points geben die MAC-Adresse ihrer Ethernet-Schnittstelle an. In diesem Fall kann die Adresse nicht verwendet werden, um das Funkgerät des AP zu finden. Wenn eine Anwendung das Funkgerät eines AP finden muss, sollte die Anwendung das attribut WCN_TYPE_BSSID abfragen, das von Windows aufgefüllt wird und im Allgemeinen zuverlässiger ist.
WCN_TYPE_MANUFACTURER Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer ist, der eine Zeichenfolge enthält, die den Hersteller des Geräts identifiziert. In der Regel sollte dieses Feld es einem Benutzer ermöglichen, eine Zuordnung zu einem Gerät mit der Bezeichnung auf dem und erhalten schnell Antworten auf Ihre Fragen.
WCN_TYPE_MESSAGE_TYPE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_MODEL_NAME Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der das Modell des Geräts identifiziert. Im Allgemeinen gilt dieses Feld. sollte es einem Benutzer ermöglichen, eine Zuordnung eines Geräts mit der Bezeichnung auf dem Gerät zu erstellen.
WCN_TYPE_MODEL_NUMBER Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode eine Zeichenfolge ist, die zusätzliche beschreibende Daten enthält, die dem Gerät zugeordnet sind.
WCN_TYPE_NETWORK_INDEX Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 1-Byte-Puffer ist, der zum Abrufen und Festlegen von Netzwerkeinstellungen für Geräte verwendet wird, die mehrere Netzwerke hosten. The Der Standardwert ist "1", der sich auf das primäre WLAN-Netzwerk auf dem Gerät bezieht.
WCN_TYPE_NETWORK_KEY Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer ist, der den drahtlosen Verschlüsselungsschlüssel enthält, der vom Enrollee verwendet werden soll. Beachten Sie, dass Anwendungen IWCNDevice::GetNetworkProfile implementieren, um Netzwerkeinstellungen in einem komfortablen Format abzurufen, das für die Verwendung mit den WLAN-Verbindungs- und Profilverwaltungs-APIs bereit ist.
WCN_TYPE_NETWORK_KEY_INDEX Reserviert. Darf nicht verwendet werden.
WCN_TYPE_NEW_DEVICE_NAME Reserviert. Darf nicht verwendet werden.
WCN_TYPE_NEW_PASSWORD Reserviert. Darf nicht verwendet werden.
WCN_TYPE_OOB_DEVICE_PASSWORD Reserviert. Darf nicht verwendet werden.
WCN_TYPE_OS_VERSION Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 4-Byte-Puffer ist, der die auf dem Gerät ausgeführte Betriebssystemversion enthält. Das wichtigste Bit dieses 4-Byte-Felds ist reserviert und immer auf eins festgelegt.
WCN_TYPE_POWER_LEVEL Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PSK_CURRENT Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PSK_MAX Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PUBLIC_KEY Reserviert. Darf nicht verwendet werden. Es wird empfohlen, ein gemeinsam genutztes Geheimnis über eine Anbietererweiterung zu senden oder eine andere Möglichkeit zur Kryptografie zu finden.
WCN_TYPE_RADIO_ENABLED Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REBOOT Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REGISTRAR_CURRENT Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REGISTRAR_ESTABLISHED Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REGISTRAR_LIST Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REGISTRAR_MAX Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REGISTRAR_NONCE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Puffer mit 16 Byte ist, der einen zufällig generierten binären Wert enthält, der von der Registrierungsstelle für Setup. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_REQUEST_TYPE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_RESPONSE_TYPE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_RF_BANDS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein ganzzahliger Wert ist, definiert durch WCN_VALUE_TYPE_RF_BANDS, der angibt, welches RF-Band während des Nachrichtenaustauschs verwendet wird, was das Ende zulässt. Punkte und Proxys für die Kommunikation über eine konsistente Funkschnittstelle. Es kann auch als optionales Verwendet werden. -Attribut in einem WCN_TYPE_CREDENTIAL oder WCN_TYPE_ENCRYPTED_SETTINGS , um eine bestimmte (oder Gruppe) von RF-Bändern anzugeben, für die ein -Einstellung gilt.
WCN_TYPE_R_HASH1 Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein 32-Byte-Puffer ist, der den HMAC-SHA-256-Hash der ersten Hälfte des Gerätekennworts und das erste Geheimnis der Registrierungsstelle enthält. Nonce. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_R_HASH2 Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein 32-Byte-Puffer ist, der den HMAC-SHA-256-Hash der zweiten Hälfte des Gerätekennworts und die zweite Der Registrierungsstelle enthält. Geheimnis-Nonce. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_R_SNONCE1 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 16-Byte-Puffer ist, der die erste Nonce enthält, die von der Registrierungsstelle mit der ersten Hälfte des Gerätekennworts verwendet wird. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_R_SNONCE2 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 16-Byte-Puffer ist, der die zweite Nonce enthält, die von der Registrierungsstelle mit der zweiten Hälfte des Gerätekennworts verwendet wird. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_SELECTED_REGISTRAR Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein ganzzahliger Wert ist, der durch WCN_VALUE_TYPE_BOOLEAN definiert wird, der angibt, ob ein Benutzer eine Registrierungsstelle ausgewählt hat und dass ein Registrierter mit fortfahren kann. Einrichten eines unkontrollierten 802.1X-Datenports mit der Registrierungsstelle.
WCN_TYPE_SERIAL_NUMBER Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode eine Zeichenfolge ist, die die Seriennummer des Enrollee enthält. Hinweis Nicht alle Geräte geben eine Seriennummer an. Einige Geräte geben eine Zeichenfolge aus nicht numerischen Zeichen zurück, daher ist es nicht immer möglich, diesen Wert in eine Zahl zu konvertieren.
WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein ganzzahliger Wert ist, definiert durch WCN_VALUE_TYPE_WI_FI_PROTECTED_SETUP, der angibt, ob ein Gerät konfiguriert ist.
WCN_TYPE_SSID Dieser Attributwert gibt an, dass der pbData-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer mit einer Größe von bis zu 32 Bytes ist und den Dienstsatzbezeichner (Service Set Identifier, SSID) oder den Netzwerknamen enthält. Anstatt dieses Attribut abzufragen, wird empfohlen, dass Anwendungen IWCNDevice::GetNetworkProfile implementieren, um Netzwerkeinstellungen in einem bequemen Format abzurufen, das für die Verwendung mit den WLAN-Verbindungs- und Profilverwaltungs-APIs bereit ist.
WCN_TYPE_TOTAL_NETWORKS Reserviert. Darf nicht verwendet werden.
WCN_TYPE_UUID_E Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 16-Byte-Puffer ist, der den vom Enrollee generierten Universally Unique Identifier (UUID) enthält. Es identifiziert ein betriebsbereites Gerät eindeutig und sollte Neustarts und Zurücksetzungen überstehen. Die UUID wird in Binärformat. Wenn das Gerät auch UPnP unterstützt, entspricht die UUID der UPnP-UUID. Anstatt dieses Attribut zu abfragen, sollten Anwendungen stattdessen das attribut WCN_TYPE_UUID abfragen, da es sowohl für Registrierungen als auch für Registrierungen verfügbar ist. WCN_TYPE_UUID_E_ ist nur für Geräte verfügbar, die als Registrierter fungieren.
WCN_TYPE_UUID_R Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein 16-Byte-Puffer ist, der das von der Registrierungsstelle generierte UUID-Element (Universally Unique Identifier) enthält. Es identifiziert ein betriebsbereites Gerät eindeutig und sollte Neustarts und Zurücksetzungen überstehen. Die UUID wird in Binärformat. Wenn das Gerät auch UPnP unterstützt, entspricht die UUID der UPnP-UUID. Anstatt dieses Attribut zu abfragen, sollten Anwendungen stattdessen das attribut WCN_TYPE_UUID abfragen, da es sowohl für Registrierte als auch für Registrare verfügbar ist.
WCN_TYPE_VENDOR_EXTENSION Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer mit einer Größe von bis zu 1024 Bytes ist, der die Verwendung von Anbietererweiterungen im TLV-Framework Wi-Fi Protected Setup ermöglicht. Der Anbieter Erweiterungsbild veranschaulicht die Implementierung von Anbietererweiterungen. Die Anbieter-ID ist der private Unternehmenscode für die SMI-Netzwerkverwaltung. Anstelle dieses Werts wird die Implementierung der IWCNDevice::GetVendorExtension-API empfohlen, um die Benutzerfreundlichkeit und Flexibilität beim direkten Zugriff auf das Rohanbietererweiterungsattribut zu erhöhen.
WCN_TYPE_VERSION Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein ganzzahliger Wert ist, der die Wi-Fi Protected Setup-Version angibt. Das Ein-Byte-Feld wird mithilfe des obere MSBs und Vier-Bit-Nebenteil mit den LSBs. Als Beispiel wäre Version 3.2 0x32. Hinweis Windows verwendet automatisch die richtige WPS-Version für jedes Gerät, sodass Anwendungen diesen Wert nicht abfragen oder festlegen müssen.   Hinweis Bei Verwendung von WPS 2.0 wird WCN_TYPE_VERSION immer auf 0x10 festgelegt, und stattdessen wird WCN_TYPE_VERSION2 verwendet.
WCN_TYPE_X_509_CERTIFICATE_REQUEST Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer ist, der eine X.509-Zertifikatanforderungsnutzlast enthält, wie in RFC 2511 angegeben.
WCN_TYPE_X_509_CERTIFICATE Dieser Attributwert gibt an, dass der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer ist, der ein X.509-Zertifikat enthält.
WCN_TYPE_EAP_IDENTITY Reserviert. Darf nicht verwendet werden.
WCN_TYPE_MESSAGE_COUNTER Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PUBLIC_KEY_HASH Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein 20-Byte-Puffer ist, der die ersten 160 Bit des SHA-256-Hashs eines öffentlichen Schlüssels enthält. Hinweis Die Sicherheit wird von Windows transparent behandelt. Daher müssen Anwendungen dieses Attribut nicht abfragen oder festlegen.
WCN_TYPE_REKEY_KEY Reserviert. Darf nicht verwendet werden.
WCN_TYPE_KEY_LIFETIME Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PERMITTED_CONFIG_METHODS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode eine ganze Zahl ist, die von WCN_VALUE_TYPE_CONFIG_METHODS definiert wird, die angibt, welche der vom Gerät unterstützten Konfigurationsmethoden aktiviert sind.
WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode eine ganze Zahl ist, die von WCN_VALUE_TYPE_CONFIG_METHODS definiert ist, die in Testantwortmeldungen verwendet wird. die aktuell unterstützten Konfigurationsmethoden einer bestimmten Registrierungsstelle zu vermitteln.
WCN_TYPE_PRIMARY_DEVICE_TYPE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 8-Byte-Puffer ist, der werte enthält, die in WCN_VALUE_TYPE_PRIMARY_DEVICE_TYPE enthalten sind und den primären Typ des Geräts angibt. Es wird empfohlen, dass Anwendungen stattdessen die Attribute WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY, WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI und WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY abfragen, da sie bequemer sind.
WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST Reserviert. Darf nicht verwendet werden.
WCN_TYPE_PORTABLE_DEVICE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_AP_SETUP_LOCKED Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein Puffer ist, der einen durch WCN_VALUE_TYPE_BOOLEAN definierten Wert enthält, der angibt, ob der Zugriffspunkt in einen Zustand eingetreten ist, in dem er die Zulassung einer externen Registrierung ablehnt. , um zu versuchen, das Registrierungsprotokoll mithilfe der PIN des AP auszuführen (wobei der AP als Registrierungsempfänger fungiert). Der AP sollte in diesen Zustand eintreten, wenn es der Ansicht ist, dass ein Brute-Force-Angriff gegen die PIN des AP im Gange ist. Wenn sich der AP in diesem Zustand befindet, MUSS er anderen Registrierten weiterhin erlauben, eine Verbindung herzustellen und auszuführen. Registrierungsprotokoll mit externen Registrierungen oder der integrierten Registrierungsstelle des AP (falls vorhanden). Es ist nur die Verwendung der PIN des AP zum Hinzufügen externer Registrierungen, die in diesem Zustand deaktiviert ist. Der Status "AP Setup Locked" kann über einen authentifizierten Aufruf von SetAPSettings auf FALSE zurückgesetzt werden. Aps kann auch andere implementierungsspezifische Methoden zum Zurücksetzen des AP Setup Locked-Zustands bereitstellen.
WCN_TYPE_APPLICATION_EXTENSION Dieser Attributwert gibt an, dass der pvBuffer-Parameter der IWCNDevice::GetAttribute-Methode ein Puffer mit einer Größe von bis zu 512 Bytes ist, der zum Übergeben von Parametern zum Aktivieren von Anwendungen während des WSC verwendet wird. Umtausch. Es ähnelt dem Attribut "Anbietererweiterung", mit dem Unterschied, dass anstelle eines 3-Byte-Anbieter-ID-Präfixes im Feld Vendor Data wird eine UUID von 16 Byte (wie in RFC 4122 definiert) verwendet. Dies bietet eine virtuelle Unbegrenzter Anwendungs-ID-Speicherplatz mit einer regulären Struktur, die einfach einem generischen zugeordnet werden kann Anwendungserweiterungs-API. Darüber hinaus kann der UUID-Wert von 16 Byte verwendet werden, um anwendungsspezifisch abzuleiten. AMSKs wie in Abschnitt 6.3 beschrieben, oder übergeben Sie alle erforderlichen Schlüssel direkt.
WCN_TYPE_EAP_TYPE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_INITIALIZATION_VECTOR Reserviert. Darf nicht verwendet werden.
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY Reserviert. Darf nicht verwendet werden.
WCN_TYPE_802_1X_ENABLED Reserviert. Darf nicht verwendet werden.
WCN_TYPE_APPSESSIONKEY Dieser Attributwert stellt den Puffer mit einer Größe von bis zu 128 Bytes dar, der Daten enthält, die auf einen Austausch anwendungsspezifischer Sitzungsschlüssel hinweisen und alternativ verwendet werden können. , um AMSKs zu berechnen.
WCN_TYPE_WEPTRANSMITKEY Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 1-Byte-Puffer ist, der Daten enthält, die den Schlüsselindexwert identifiziert, der als Access Point-Übertragungsschlüssel für WEP-Konfigurationen verwendet wird.
WCN_TYPE_UUID Dieses zusammengesetzte Attribut gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 16-Byte-Puffer ist, der Daten enthält, die immer der UUID des Geräts entsprechen, unabhängig davon, ob das Gerät registriert oder registriert ist. (Führt effektiv WCN_TYPE_UUID_E und WCN_TYPE_UUID_R zusammen).
WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY Dieser Attributwert gibt an, dass der puInteger-Parameter des IWCNDevice::GetIntegerAttribute eine ganze Zahl ist, die die Hauptgerätekategorie eines WCN-Geräts darstellt. Die Hauptgerätekategorie ist einer der WCN_VALUE_TYPE_DEVICE_TYPE_CATEGORY Werte.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI Dieser Attributwert gibt an, dass der puInteger-Parameter des IWCNDevice::GetIntegerAttribute eine ganze Zahl ist, die die OUI darstellt, die die Geräteunterkategorie eines WCN-Geräts definiert. Die häufigste OUI ist WCN_VALUE_DT_SUBTYPE_WIFI_OUI die angibt, dass die Unterkategorie durch die Wi-Fi Alliance definiert wird.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY Dieser Attributwert gibt an, dass der puInteger-Parameter des IWCNDevice::GetIntegerAttribute eine ganze Zahl ist, die die Geräteunterkategorie eines WCN-Geräts darstellt. Die Unterkategorie muss zusammen mit der OUI aus WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI interpretiert werden. Für Geräte, die die Wi-Fi Alliance OUI verwenden. Die Unterkategorie ist einer der WCN_VALUE_TYPE_DEVICE_TYPE_SUBCATEGORY Werte.
WCN_TYPE_CURRENT_SSID Dieser Attributwert gibt an, dass der wszString-Parameter der IWCNDevice::GetStringAttribute-Methode ein Puffer mit einer Größe von bis zu 32 Bytes ist und die aktuelle SSID eines drahtlosen Zugriffspunkts enthält.
WCN_TYPE_BSSID Reserviert. Darf nicht verwendet werden.
WCN_TYPE_DOT11_MAC_ADDRESS Reserviert. Darf nicht verwendet werden.
WCN_TYPE_AUTHORIZED_MACS . Dieser Attributwert gibt an, dass eine Registrierungsstelle eine Liste der MAC-Adressen bereitstellt, die zum Starten von WSC autorisiert sind. Der pbBuffer-Parameter der IWCNDevice::GetAttribute-Methode ist ein 6-30-Byte-Puffer, der den 48-Bit-Wert jeder MAC-Adresse in der Liste der autorisierten MACs enthält. Beispiel: 0x00 0x07 0xE9 0x4C 0xA8 0x1C. Hinweis Nur in Windows 8 verfügbar.
WCN_TYPE_NETWORK_KEY_SHAREABLE Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 1-Byte-Puffer ist, der zum Abrufen und Festlegen von Netzwerkeinstellungen für Geräte verwendet wird, die mehrere Netzwerke hosten. Der Wert "1" gibt an, dass der Netzwerkschlüssel möglicherweise für andere Geräte freigegeben werden kann. Hinweis Nur in Windows 8 verfügbar.
WCN_TYPE_REQUEST_TO_ENROLL Reserviert. Darf nicht verwendet werden.
WCN_TYPE_REQUESTED_DEVICE_TYPE Reserviert. Darf nicht verwendet werden.
WCN_TYPE_SETTINGS_DELAY_TIME Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein 1 Bytepuffer ist, der die geschätzte Zeitdauer (in Sekunden) angibt, die ein Zugriffspunkt benötigt, um sich selbst neu zu konfigurieren und verfügbar zu werden, oder dass ein Gerät Einstellungen anwenden und eine Verbindung mit einem Netzwerk herstellen muss. Hinweis Nur in Windows 8 verfügbar.
WCN_TYPE_VERSION2 Dieser Attributwert gibt an, dass der puInteger-Parameter der IWCNDevice::GetIntegerAttribute-Methode ein ganzzahliger Wert ist, der die Wi-Fi Protected Setup-Version angibt. Das Ein-Byte-Feld wird mithilfe des obere MSBs und Vier-Bit-Nebenteil mit den LSBs. Als Beispiel wäre Version 3.2 0x32. Hinweis Windows verwendet automatisch die richtige WPS-Version für jedes Gerät, sodass Anwendungen diesen Wert nicht abfragen oder festlegen müssen.   Hinweis Nur in Windows 8 verfügbar.
WCN_TYPE_VENDOR_EXTENSION_WFA Reserviert. Darf nicht verwendet werden. Hinweis Die Attribute innerhalb der WFA-Anbietererweiterung können direkt abgefragt werden.
WCN_NUM_ATTRIBUTE_TYPES Die Anzahl der zugewiesenen Attribute.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	wcntypes.h