enumerazione WCN_ATTRIBUTE_TYPE (wcntypes.h)
L'enumerazione WCN_ATTRIBUTE_TYPE definisce i tipi di buffer degli attributi definiti per Wi-Fi Programma di installazione protetta. Le dimensioni complessive occupate da ogni buffer di attributi includono altri 4 byte (2 byte di ID, 2 byte di lunghezza).
Sintassi
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;
Costanti
WCN_TYPE_AP_CHANNELValore: 0 Questo valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore contenente dati che specifica il canale 802.11 che ospita il punto di accesso. |
WCN_TYPE_ASSOCIATION_STATEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore contenente lo stato di associazione o le informazioni di configurazione definite da WCN_VALUE_TYPE_ASSOCIATION_STATE. |
WCN_TYPE_AUTHENTICATION_TYPEQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore contenente un tipo di autenticazione definito da WCN_VALUE_TYPE_AUTHENTICATION_TYPE. |
WCN_TYPE_AUTHENTICATION_TYPE_FLAGSQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore contenente dati che specifica le funzionalità di autenticazione di rete dell'oggetto Enrollee (punto di accesso o stazione) fornendo un valore valore definito da WCN_VALUE_TYPE_AUTHENTICATION_TYPE. |
WCN_TYPE_AUTHENTICATORQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer contenente un hash con chiave di dati. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_CONFIG_METHODSQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene valori, definiti da WCN_VALUE_TYPE_CONFIG_METHODS, che specificano i metodi di configurazione supportati da Enrollee o Registrar. Inoltre, punti di accesso e stazioni che supportano l'interfaccia di gestione UPnP deve supportare anche questo attributo, che viene usato per controllare i metodi di configurazione abilitati nel punto di accesso. |
WCN_TYPE_CONFIGURATION_ERRORQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore, definito da WCN_VALUE_TYPE_CONFIGURATION_ERROR, che specifica il risultato del dispositivo che tenta di configurare se stesso e associarlo a WLAN. Se una sessione di configurazione non riesce con il codice di errore WCN_E_CONNECTION_REJECTED, è possibile ottenere qualsiasi codice di errore restituito dal dispositivo remoto eseguendo una query su questo attributo. È importante notare che alcuni dispositivi restituiranno WCN_VALUE_CE_NO_ERROR anche se si è verificato un errore. |
WCN_TYPE_CONFIRMATION_URL4Questo valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer che contiene i dati che rappresentano l'URL (basato sull'indirizzo IPv4) fornito dal registrar all'oggetto Enrollee per l'uso nella conferma della registrazione dopo che le impostazioni sono state applicate correttamente e la rete è stata aggiunta. Questa configurazione il parametro è facoltativo per un registrar ed è facoltativo per l'iscrizione all'URL se registrar include esso. Nota Un oggetto Enrollee non deve connettersi a un URL di conferma che si trova in una subnet diversa. |
WCN_TYPE_CONFIRMATION_URL6Questo valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer che contiene i dati che rappresentano l'URL (indirizzo IPv6) fornito dal Registrar all'oggetto Enrollee per l'uso nella pubblicazione di una conferma dopo che le impostazioni sono state applicate correttamente e la rete è stata aggiunta. Questa configurazione il parametro è facoltativo per un registrar ed è facoltativo per l'iscrizione all'URL se registrar include esso. Nota L'oggetto Enrolle non deve connettersi a un URL di conferma che si trova in una subnet diversa. |
WCN_TYPE_CONNECTION_TYPEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore, definito da WCN_VALUE_TYPE_CONNECTION_TYPE, che specifica la funzionalità di connessione dell'oggetto Enrollee. |
WCN_TYPE_CONNECTION_TYPE_FLAGSQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore, definito da WCN_VALUE_TYPE_CONNECTION_TYPE, che specifica la funzionalità di connessione dell'oggetto Enrollee. |
WCN_TYPE_CREDENTIALQuesto valore di attributo composto indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute contiene una singola credenziale WLAN. Possono essere presenti più attributi di credenziale per ogni chiave di rete o più Chiavi di rete in un singolo attributo Credential, che viene eseguito ripetendo l'indice della chiave di rete e gli attributi che seguirlo. In genere, più è consigliabile usare le chiavi in una singola credenziale per un singolo SSID e più attributi Credential per è consigliabile usare SSID separati. Gli attributi seguenti sono contenuti in ogni istanza di Credential:
Se un'applicazione intende usare le credenziali di rete con l'API WLAN, deve usare IWCNDevice::GetNetworkProfile per ottenere direttamente un profilo di rete XML compatibile. |
WCN_TYPE_DEVICE_NAMEQuesto valore di attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer che contiene una descrizione intuitiva del dispositivo codificato in UTF-8. In genere, il componente sarebbe un identificatore univoco che descrive il prodotto in modo riconoscibile per l'utente. |
WCN_TYPE_DEVICE_PASSWORD_IDQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore, definito da WCN VALUE TYPE DEVICE_PASSWORD_ID, usato per identificare una password del dispositivo. |
WCN_TYPE_E_HASH1Questo valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute contiene l'hash HMAC-SHA-256 della prima metà della password del dispositivo e il primo segreto di Enrollee nonce. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_E_HASH2Questo valore dell'attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute contiene l'hash HMAC-SHA-256 della seconda metà della password del dispositivo e il secondo oggetto Enrollee segreto nonce. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_E_SNONCE1Questo valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene il primo nonce usato da Enrollee con la prima metà della password del dispositivo. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_E_SNONCE2Questo valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene il secondo nonce usato dall'oggetto Enrollee con la seconda metà della password del dispositivo. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_ENCRYPTED_SETTINGSQuesto valore dell'attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute contiene un vettore di inizializzazione (IV) seguito da un set di attributi TLV di installazione protetta di Wi-Fi crittografati. L'ultimo attributo nel set crittografato è un wrapping della chiave Autenticatore calcolato in base alla procedura descritta nella sezione 6.5. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_ENCRYPTION_TYPEQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore, definito da WCN_VALUE_TYPE_ENCRYPTION_TYPE, per Enrollee (AP o stazione) da utilizzare. |
WCN_TYPE_ENCRYPTION_TYPE_FLAGSQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore, definito da WCN_VALUE_TYPE_ENCRYPTION_TYPE, per Enrollee (AP o stazione) da utilizzare. |
WCN_TYPE_ENROLLEE_NONCEQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene un valore binario generato in modo casuale creato da Enrollee per operazioni di installazione. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_FEATURE_IDQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute contiene dati che indicano una particolare build di funzionalità per un sistema operativo in esecuzione nel dispositivo. Il bit più significativo dell'intero a 4 byte è riservato e impostato sempre su uno. |
WCN_TYPE_IDENTITYRiservato. Non usare. |
WCN_TYPE_IDENTITY_PROOFRiservato. Non usare. |
WCN_TYPE_KEY_WRAP_AUTHENTICATORQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer a 8 byte contenente i primi 64 bit dell'HMAC-SHA-256 calcolato sui dati da crittografare con l'algoritmo di incapsulamento della chiave. Viene aggiunto alla fine di ConfigData prima della crittografia. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_KEY_IDENTIFIERQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetAttribute è un buffer a 16 byte contenente un identificatore di chiave a 128 bit. Se questo attributo precede immediatamente un oggetto Encrypted Data o Attributo Authenticator, quindi la chiave corrispondente all'identificatore a 128 bit deve essere usata per decrittografare o verificare il campo Dati. |
WCN_TYPE_MAC_ADDRESSQuesto valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer a 6 byte contenente il valore a 48 bit dell'indirizzo MAC. For esempio: 0x00 0x07 0xE9 0x4C 0xA8 0x1C. Questo indirizzo viene fornito dal dispositivo remoto. Alcuni punti di accesso forniscono l'indirizzo MAC dell'interfaccia Ethernet, nel qual caso l'indirizzo non può essere usato per individuare la radio wireless dell'AP. Se un'applicazione deve individuare la radio di un'API, l'applicazione deve eseguire una query sull'attributo WCN_TYPE_BSSID, popolato da Windows ed è in genere più affidabile. |
WCN_TYPE_MANUFACTURERQuesto valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer contenente una stringa che identifica il produttore del dispositivo. In genere, questo campo deve consentire a un utente di creare un'associazione con un dispositivo con l'etichettatura nel dispositivo. |
WCN_TYPE_MESSAGE_TYPERiservato. Non usare. |
WCN_TYPE_MODEL_NAMEQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer che identifica il modello del dispositivo. In genere, questo campo deve consentire a un utente di creare un'associazione di un dispositivo con l'etichettatura nel dispositivo. |
WCN_TYPE_MODEL_NUMBERQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è una stringa contenente dati descrittivi aggiuntivi associati al dispositivo. |
WCN_TYPE_NETWORK_INDEXQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 1 byte usato per ottenere e impostare le impostazioni di rete per i dispositivi che ospitano più reti. The il valore predefinito è '1' che fa riferimento alla rete WLAN primaria nel dispositivo. |
WCN_TYPE_NETWORK_KEYQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer contenente la chiave di crittografia wireless da usare da Enrollee. Si noti che è consigliabile che le applicazioni implementino IWCNDevice::GetNetworkProfile per ottenere le impostazioni di rete in un formato pratico che sia pronto per essere usato con le API di gestione dei profili e della connessione WLAN. |
WCN_TYPE_NETWORK_KEY_INDEXRiservato. Non usare. |
WCN_TYPE_NEW_DEVICE_NAMERiservato. Non usare. |
WCN_TYPE_NEW_PASSWORDRiservato. Non usare. |
WCN_TYPE_OOB_DEVICE_PASSWORDRiservato. Non usare. |
WCN_TYPE_OS_VERSIONQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 4 byte che contiene la versione del sistema operativo in esecuzione nel dispositivo. Il bit più significativo di questo campo a 4 byte è riservato e sempre impostato su uno. |
WCN_TYPE_POWER_LEVELRiservato. Non usare. |
WCN_TYPE_PSK_CURRENTRiservato. Non usare. |
WCN_TYPE_PSK_MAXRiservato. Non usare. |
WCN_TYPE_PUBLIC_KEYRiservato. Non usare. È consigliabile inviare un segreto condiviso tramite un'estensione del fornitore o trovare un altro modo per eseguire la crittografia. |
WCN_TYPE_RADIO_ENABLEDRiservato. Non usare. |
WCN_TYPE_REBOOTRiservato. Non usare. |
WCN_TYPE_REGISTRAR_CURRENTRiservato. Non usare. |
WCN_TYPE_REGISTRAR_ESTABLISHEDRiservato. Non usare. |
WCN_TYPE_REGISTRAR_LISTRiservato. Non usare. |
WCN_TYPE_REGISTRAR_MAXRiservato. Non usare. |
WCN_TYPE_REGISTRAR_NONCEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 16 byte contenente un valore binario generato in modo casuale creato dal Registrar per Installazione. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_REQUEST_TYPERiservato. Non usare. |
WCN_TYPE_RESPONSE_TYPERiservato. Non usare. |
WCN_TYPE_RF_BANDSQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore intero, definito da WCN_VALUE_TYPE_RF_BANDS, che indica la banda RF utilizzata durante lo scambio di messaggi, consentendo la fine punti e proxy per comunicare tramite un'interfaccia radio coerente. Può anche essere usato come facoltativo attributo in un WCN_TYPE_CREDENTIAL o WCN_TYPE_ENCRYPTED_SETTINGS per indicare uno specifico (o gruppo) di bande RF a cui un si applica l'impostazione. |
WCN_TYPE_R_HASH1Questo valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer a 32 byte che contiene l'hash HMAC-SHA-256 della prima metà della password del dispositivo e il primo segreto del registrar nonce. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_R_HASH2Questo valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer a 32 byte contenente l'hash HMAC-SHA-256 della seconda metà della password del dispositivo e il secondo registrar segreto nonce. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_R_SNONCE1Questo valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 16 byte contenente il primo nonce usato dal Registrar con la prima metà della password del dispositivo. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_R_SNONCE2Questo valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 16 byte contenente il secondo nonce usato dal Registrar con la seconda metà della password del dispositivo. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_SELECTED_REGISTRARQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore intero, definito da WCN_VALUE_TYPE_BOOLEAN, che indica se un registrar è stato selezionato da un utente e che un oggetto Enrollee può procedere con configurazione di una porta dati non controllata 802.1X con registrar. |
WCN_TYPE_SERIAL_NUMBERQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è una stringa contenente il numero di serie dell'oggetto Enrollee. Nota Non tutti i dispositivi forniscono un numero di serie. Alcuni dispositivi restituiscono una stringa di caratteri non numerici e di conseguenza non è sempre possibile convertire questo valore in un numero. |
WCN_TYPE_WI_FI_PROTECTED_SETUP_STATEQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore intero, definito da WCN_VALUE_TYPE_WI_FI_PROTECTED_SETUP, che indica se un dispositivo è configurato. |
WCN_TYPE_SSIDQuesto valore di attributo indica che il parametro pbData del metodo IWCNDevice::GetAttribute è un buffer, fino a 32 byte, contenente il nome di rete o l'identificatore del set di servizi (SSID). Invece di eseguire query su questo attributo, è consigliabile che le applicazioni implementino IWCNDevice::GetNetworkProfile per recuperare le impostazioni di rete in un formato pratico che è pronto per essere usato con le API di gestione della connessione WLAN e del profilo. |
WCN_TYPE_TOTAL_NETWORKSRiservato. Non usare. |
WCN_TYPE_UUID_EQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 16 byte contenente l'UUID (Universally Unique Identifier) generato dall'oggetto Enrollee. Esso identifica in modo univoco un dispositivo operativo e deve sopravvivere ai riavvii e alle reimpostazioni. L'UUID è disponibile in formato binario. Se il dispositivo supporta anche UPnP, l'UUID corrisponde all'UUID UPnP. Anziché eseguire query su questo attributo, le applicazioni devono invece eseguire query sull'attributo WCN_TYPE_UUID, perché è disponibile sia per gli iscritti che per i registrar. WCN_TYPE_UUID_E_ è disponibile solo per i dispositivi che fungono da registrazione. |
WCN_TYPE_UUID_RQuesto valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer a 16 byte contenente l'elemento UUID (Universally Unique Identifier) generato dal Registrar. Esso identifica in modo univoco un dispositivo operativo e deve sopravvivere ai riavvii e alle reimpostazioni. L'UUID è disponibile in formato binario. Se il dispositivo supporta anche UPnP, l'UUID corrisponde all'UUID UPnP. Anziché eseguire query su questo attributo, le applicazioni devono invece eseguire query sull'attributo WCN_TYPE_UUID, perché è disponibile sia per gli iscritti che per i registrar. |
WCN_TYPE_VENDOR_EXTENSIONQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetAttribute è un buffer, fino a 1024 byte, che consente l'uso delle estensioni fornitore nel framework TLV di installazione protetta di Wi-Fi. Fornitore La figura dell'estensione illustra l'implementazione delle estensioni del fornitore. L'ID fornitore è il codice aziendale privato di gestione della rete SMI. Invece di eseguire query su questo valore, l'implementazione dell'API IWCNDevice::GetVendorExtension è consigliata per praticità e flessibilità durante l'accesso diretto all'attributo di estensione del fornitore non elaborato. |
WCN_TYPE_VERSIONQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore intero che indica la versione di installazione protetta Wi-Fi. Il campo a un byte è suddiviso in una parte principale a quattro bit usando il top MSBs e parte secondaria a quattro bit usando i LSB. Ad esempio, la versione 3.2 sarà 0x32. Nota Windows userà automaticamente la versione WPS corretta per ogni dispositivo, quindi le applicazioni non sono necessarie per eseguire query o impostare questo valore. Nota Quando si usa WPS 2.0, WCN_TYPE_VERSION verrà sempre impostato su 0x10 e WCN_TYPE_VERSION2 viene usato invece |
WCN_TYPE_X_509_CERTIFICATE_REQUESTQuesto valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer contenente un payload della richiesta di certificato X.509 come specificato in RFC 2511. |
WCN_TYPE_X_509_CERTIFICATEQuesto valore di attributo indica che il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer contenente un certificato X.509. |
WCN_TYPE_EAP_IDENTITYRiservato. Non usare. |
WCN_TYPE_MESSAGE_COUNTERRiservato. Non usare. |
WCN_TYPE_PUBLIC_KEY_HASHQuesto valore dell'attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è un buffer a 20 byte contenente i primi 160 bit dell'hash SHA-256 di una chiave pubblica. Nota La sicurezza viene gestita in modo trasparente da Windows. Di conseguenza, le applicazioni non devono eseguire query o impostare questo attributo. |
WCN_TYPE_REKEY_KEYRiservato. Non usare. |
WCN_TYPE_KEY_LIFETIMERiservato. Non usare. |
WCN_TYPE_PERMITTED_CONFIG_METHODSQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un numero intero definito da WCN_VALUE_TYPE_CONFIG_METHODS, che indica quali metodi di configurazione supportati dal dispositivo sono abilitati. |
WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODSQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un numero intero definito da WCN_VALUE_TYPE_CONFIG_METHODS, usato nei messaggi Probe Response a comunicare i metodi di configurazione supportati correnti di un registrar specifico. |
WCN_TYPE_PRIMARY_DEVICE_TYPEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer di 8 byte contenente valori, contenuti in WCN_VALUE_TYPE_PRIMARY_DEVICE_TYPE, che indica il tipo primario del dispositivo. È consigliabile che le applicazioni eseseguono invece query sugli attributi WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY, WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI e WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY in quanto sono più pratici. |
WCN_TYPE_SECONDARY_DEVICE_TYPE_LISTRiservato. Non usare. |
WCN_TYPE_PORTABLE_DEVICERiservato. Non usare. |
WCN_TYPE_AP_SETUP_LOCKEDQuesto valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer contenente un valore, definito da WCN_VALUE_TYPE_BOOLEAN, che indica se il punto di accesso ha immesso uno stato in cui si rifiuterà di consentire un registrar esterno per tentare di eseguire il protocollo di registrazione usando il PIN dell'API (con l'API che funge da Enrollee). L'API dovrebbe entrare in questo stato se ritiene che sia in corso un attacco di forza bruta contro il PIN dell'API. Quando l'API è in questo stato, deve continuare a consentire ad altri iscritti di connettersi ed eseguire Protocollo di registrazione con qualsiasi registrar esterno o registrar predefinito dell'API (se presente). È solo l'uso del PIN dell'API per l'aggiunta di registrar esterni disabilitati in questo stato. Lo stato AP Setup Locked può essere reimpostato su FALSE tramite una chiamata autenticata a SetAPSettings. Aps può fornire anche altri metodi specifici dell'implementazione per reimpostare lo stato AP Setup Locked. |
WCN_TYPE_APPLICATION_EXTENSIONQuesto valore di attributo indica che il parametro pvBuffer del metodo IWCNDevice::GetAttribute è un buffer, fino a 512 byte, usato per passare parametri per abilitare le applicazioni durante il WSC sostituzione. È simile all'attributo Vendor Extension, ad eccezione del fatto che invece di un prefisso di ID fornitore a 3 byte nel campo Dati fornitore viene usato un UUID a 16 byte (come definito in RFC 4122). Ciò fornisce praticamente spazio ID applicazione illimitato con una struttura regolare che può essere facilmente mappata a un generico API dell'estensione dell'applicazione. Inoltre, il valore UUID a 16 byte può essere usato per derivare applicazionipecifiche I pacchetti AMSK come descritto nella sezione 6.3 o passano direttamente le chiavi necessarie. |
WCN_TYPE_EAP_TYPERiservato. Non usare. |
WCN_TYPE_INITIALIZATION_VECTORRiservato. Non usare. |
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLYRiservato. Non usare. |
WCN_TYPE_802_1X_ENABLEDRiservato. Non usare. |
WCN_TYPE_APPSESSIONKEYQuesto valore dell'attributo rappresenta il buffer, fino a 128 byte di dimensioni, contenente dati che indicano uno scambio di chiavi di sessione specifiche dell'applicazione e, in alternativa, possono essere usati per calcolare amsk. |
WCN_TYPE_WEPTRANSMITKEYQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 1 byte contenente i dati che identificano il valore dell'indice chiave usato come chiave di trasmissione del punto di accesso per le configurazioni WEP. |
WCN_TYPE_UUIDQuesto attributo composto indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 16 byte che contiene dati sempre uguali all'UUID del dispositivo, indipendentemente dal fatto che il dispositivo sia registrato o registrar. (In effetti, unisce WCN_TYPE_UUID_E e WCN_TYPE_UUID_R). |
WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORYQuesto valore di attributo indica che il parametro puInteger di IWCNDevice::GetIntegerAttribute è un numero intero che rappresenta la categoria principale di dispositivo di un dispositivo WCN. La categoria di dispositivi principale è uno dei valori WCN_VALUE_TYPE_DEVICE_TYPE_CATEGORY. |
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUIQuesto valore dell'attributo indica che il parametro puInteger di IWCNDevice::GetIntegerAttribute è un numero intero che rappresenta l'OUI che definisce la sottocategoria del dispositivo di un dispositivo WCN. L'OUI più comune è WCN_VALUE_DT_SUBTYPE_WIFI_OUI che indica che la sottocategoria è definita dalla Wi-Fi Alliance. |
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORYQuesto valore di attributo indica che il parametro puInteger di IWCNDevice::GetIntegerAttribute è un numero intero che rappresenta la sottocategoria del dispositivo di un dispositivo WCN. La sottocategoria deve essere interpretata insieme all'interfaccia utente di WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI. Per i dispositivi che usano Wi-Fi Alliance OUI. La sottocategoria è uno dei valori WCN_VALUE_TYPE_DEVICE_TYPE_SUBCATEGORY. |
WCN_TYPE_CURRENT_SSIDQuesto valore di attributo indica che il parametro wszString del metodo IWCNDevice::GetStringAttribute è buffer, fino a 32 byte, contenente l'SSID corrente di un punto di accesso wireless. |
WCN_TYPE_BSSIDRiservato. Non usare. |
WCN_TYPE_DOT11_MAC_ADDRESSRiservato. Non usare. |
WCN_TYPE_AUTHORIZED_MACS. Questo valore di attributo indica che un registrar fornisce un elenco di indirizzi MAC autorizzati ad avviare WSC. Il parametro pbBuffer del metodo IWCNDevice::GetAttribute è un buffer a 6-30 byte contenente il valore a 48 bit di ogni indirizzo MAC nell'elenco dei controller di dominio autorizzati. Ad esempio: 0x00 0x07 0xE9 0x4C 0xA8 0x1C. Nota Disponibile solo in Windows 8. |
WCN_TYPE_NETWORK_KEY_SHAREABLEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 1 byte usato per ottenere e impostare le impostazioni di rete per i dispositivi che ospitano più reti. Il valore "1" indica che la chiave di rete può essere condivisa con altri dispositivi. Nota Disponibile solo in Windows 8. |
WCN_TYPE_REQUEST_TO_ENROLLRiservato. Non usare. |
WCN_TYPE_REQUESTED_DEVICE_TYPERiservato. Non usare. |
WCN_TYPE_SETTINGS_DELAY_TIMEQuesto valore di attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un buffer a 1 byte che indica la durata stimata (in secondi) che un punto di accesso dovrà riconfigurare se stesso e diventare disponibile oppure che un dispositivo dovrà applicare le impostazioni e connettersi a una rete. Nota Disponibile solo in Windows 8. |
WCN_TYPE_VERSION2Questo valore dell'attributo indica che il parametro puInteger del metodo IWCNDevice::GetIntegerAttribute è un valore intero che indica la versione di installazione protetta Wi-Fi. Il campo a un byte è suddiviso in una parte principale a quattro bit usando il top MSBs e parte secondaria a quattro bit usando i LSB. Ad esempio, la versione 3.2 sarà 0x32. Nota Windows userà automaticamente la versione WPS corretta per ogni dispositivo, quindi le applicazioni non sono necessarie per eseguire query o impostare questo valore. Nota Disponibile solo in Windows 8. |
WCN_TYPE_VENDOR_EXTENSION_WFARiservato. Non usare. Nota Gli attributi all'interno dell'estensione fornitore WFA possono essere sottoposti direttamente a query. |
WCN_NUM_ATTRIBUTE_TYPESNumero di attributi assegnati. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | wcntypes.h |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per