sharedKey (安全性) 專案

發行項
06/26/2023

sharedKey (安全性) 元素包含共用金鑰資訊。只有在驗證和加密配對需要 WEP 或 PSK 金鑰時，才需要此元素。

<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>

父元素

安全性 (MSM)

子元素

元素	類型	描述
keyType		索引鍵的類型。
保護	boolean	指定是否加密共用金鑰。
keyMaterial	string	包含網路金鑰或複雜密碼。

keyType

指出共用金鑰是否為網路金鑰或複雜密碼。

當加密專案具有 WEP 的值時， keyType 必須設定為 networkKey。

protected

指定是否加密共用金鑰。

例如，如果設定檔是從設定檔存放區擷取 (，則Windows Vista 和 Windows Server 2008：protected一律具有「TRUE」值，例如呼叫WlanGetProfile) 。

Windows XP with Service Pack 3 (SP3) 或 Wireless LAN API for Windows XP with Service Pack 2 (SP2) ： 此元素的值必須為「FALSE」。

keyMaterial

包含網路金鑰或複雜密碼。如果 受保護的 專案值為 TRUE，則會加密此金鑰資料;否則，金鑰內容是未加密的。加密金鑰內容是以十六進位形式表示。

keyMaterial 元素的有效值範圍會因驗證和加密類型而有所不同，如驗證和加密元素所指定。它也會因 keyType而有所不同。

下表顯示某些驗證和加密組的有效 keyMaterial 值。

驗證值	加密值	keyType 值	有效的 keyMaterial 值
開啟或共用	WEP	networkKey	此元素包含 5 或 13 個 ANSI 字元的 WEP 索引鍵，或 10 或 26 個十六進位字元。
WPAPSK 或 WPA2PSK	TKIP 或 AES	passPhrase	此元素包含 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 和 Wireless LAN API for Windows XP with SP2： 金鑰資料永遠不會加密。

如果您的進程是在 LocalSystem 帳戶的內容中執行，您可以呼叫 CryptUnprotectData來取消加密金鑰資料。

備註

針對 Windows Vista 和 Windows Server 2008，與 sharedKey 元素相關聯的資料會在儲存在設定檔存放區之前加密。

針對 Windows XP 搭配 SP3 和適用于 Windows XP SP2 的無線區域網路 API，資料不會加密。

範例

若要檢視使用 sharedKey 元素及其子項目的範例設定檔，請參閱非廣播設定檔範例、 WPA-Personal 設定檔範例和 WPA2-Personal 設定檔範例。若要檢視使用 受保護 元素的範例設定檔，請參閱無線設定檔範例。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
可轉散發套件	Windows XP 搭配 SP2 的無線區域網路 API

共用方式為