共用方式為

sharedKey (安全性) 專案

  • 發行項

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>

父元素

子元素

元素 類型 描述
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