sharedKey （security） 元素包含共用密鑰資訊。 這個元素是選擇性的，只有在驗證和加密組的配置檔中必須包含WEP、PSK 或 SAE 金鑰時才需要。
<xs:element name="sharedKey"
minOccurs="0"
>
<xs:complexType>
<xs:sequence>
<xs:element name="keyType">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="networkKey">
<xs:enumeration value="passPhrase">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="protected"
type="boolean"
/>
<xs:element name="keyMaterial"
type="string"
/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
父元素
子專案
| 元素 | 類型 | 說明 |
|---|---|---|
| keyType | 索引鍵的類型。 | |
| 保護 | 布爾值 | 指定是否加密共享金鑰。 |
| keyMaterial | 字串 | 包含網路金鑰或複雜密碼。 |
鍵類型
指出共用金鑰是否為網路金鑰或傳遞片語。
當 加密 專案有 WEP 的值時， keyType 必須設定為 networkKey。 當其值為 WPA3SAE 時， keyType 必須設定為 passPhrase。
受保護
指定是否加密共享金鑰。
如果配置檔是從配置檔存放區擷取配置檔，則 Windows Vista 和 Windows Server 2008：protected 一律具有 “TRUE” 的值（例如，藉由呼叫 WlanGetProfile）。
Windows XP with Service Pack 3 （SP3） 或適用於 Windows XP Service Pack 2 的無線 LAN API （SP2）： 這個項目必須有 「FALSE」 的值。
金鑰材質
包含網路金鑰或複雜密碼。 如果 受保護的 專案值為TRUE，則會加密此金鑰數據;否則，金鑰內容為未加密。 加密金鑰資料會以十六進位形式表示。
keyMaterial 元素的有效值範圍會因驗證和加密專案所指定的驗證和加密類型而有所不同。 它也會因 keyType 而有所不同。
下表顯示某些驗證和加密組的有效 keyMaterial 值。
| 驗證 值 | 加密 值 | keyType 值 | 有效的 keyMaterial 值 |
|---|---|---|---|
| 開啟或共用 | WEP | networkKey | 此元素包含 5 或 13 個 ANSI 字元的 WEP 索引鍵，或 10 或 26 個十六進位字元。 |
| WPAPSK 或 WPA2PSK | TKIP 或 AES | 密碼短語 | 此元素包含 8 到 63 個 ASCII 字元的複雜密碼，也就是 32 到 126 範圍內的 8 到 63 個 ANSI 字元。 索引鍵值必須符合 802.11i 所指定的需求。 |
| WPA3SAE | 高級加密標準 (AES) | 密碼短語 | 此元素包含 8 到 63 個 ASCII 字元的複雜密碼，也就是 32 到 126 範圍內的 8 到 63 個 ANSI 字元。 索引鍵值必須符合 802.11i 所指定的需求。 |
| WPAPSK 或 WPA2PSK | TKIP 或 AES | networkKey | 這個專案包含64個十六進位字元的索引鍵。 |
您可以在上面指定 ANSI 或 ASCII 字元的位置輸入 Unicode 字元。 不過，如果提供的 Unicode 字元無法對應至 ANSI 或 ASCII 字元，則提供的金鑰數據會遭到拒絕。
WlanGetProfile 傳回的金鑰數據一律會加密。 此外，如果將未加密的密鑰數據傳遞至 WlanSetProfile，金鑰數據就會在設定檔存放區中儲存之前自動加密。
Windows XP with SP3 and Wireless LAN API for Windows XP with SP2： 金鑰資料永遠不會加密。
如果您的行程是在 LocalSystem 帳戶的內容中執行，您可以呼叫 CryptUnprotectData 來取消加密金鑰內容。
備註
針對 Windows Vista 和 Windows Server 2008，與 sharedKey 元素相關聯的數據會在配置檔存放區中儲存之前加密。
針對 Windows XP 搭配 SP3 和 Windows XP 搭配 SP2 的無線 LAN API，數據不會加密。
範例
若要檢視使用 sharedKey 元素及其子元素的範例設定檔，請參閱 非廣播配置檔範例、 WPA-Personal 配置檔範例，以及 WPA2-Personal 配置檔範例。 若要檢視使用 受保護 專案的範例配置檔，請參閱 無線配置檔範例。
需求
| 要求 | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP 與 SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 可再發行套件 | Windows XP 與 SP2 的無線 LAN API |