列舉網路上的裝置
使用 Windows.Devices.Enumeration API，透過無線和網路通訊協定列舉裝置。
重要 API
透過網路或無線通訊協定列舉裝置
有時，您需要列舉未本機連接且只能透過無線或網路通訊協定探索的裝置。 若要這麼做，Windows.Devices.Enumeration API 有三種不同類型的裝置物件：AssociationEndpoint (AEP)、AssociationEndpointContainer (AEP 容器) 和 AssociationEndpointService (AEP 服務)。 這些物件會作為一個群組，稱為 AEP 或 AEP 物件。
某些裝置 API 會提供選取器字串，您可以使用它來列舉可用的 AEP 物件。 這可能包括與系統配對和未配對的裝置。 有些裝置可能不需要配對。 如果在與裝置互動之前需要配對，這些裝置 API 可能會嘗試對裝置進行配對。 Wi-Fi Direct 是遵循此模式的 API 範例。 如果這些裝置 API 不會自動配對裝置，您可以使用 DeviceInformation.Pairing 中提供的 DeviceInformationPairing 物件進行配對。
但是，在某些情況下，您可能希望自己手動探索裝置，而不使用預先定義的選取器字串。 例如，您可能只需要收集有關 AEP 裝置的資訊而不與它們互動，或者您可能想要尋找比使用預先定義選取器字串探索的更多 AEP 物件。 在這種情況下，您將建置自己的選取器字串，並按照建置裝置選取器下的說明使用它。
當您建立自己的選取器時，強烈建議您將列舉範圍限制為您感興趣的通訊協定。 例如，如果您對 UPnP 裝置特別感興趣，則您不會希望透過 Wi-Fi 無線電搜尋 Wi-Fi Direct 裝置。 Windows 為每個通訊協定定義了身分識別，您可以使用它來確定列舉的範圍。 下表列出了通訊協定類型和識別碼。
| 通訊協定或網路裝置類型 | Id |
|---|---|
| UPnP (包括 DIAL 和 DLNA) | {0e261de4-12f0-46e6-91ba-428607ccef64} |
| 裝置上的 Web 服務 (WSD) | {782232aa-a2f9-4993-971b-aedc551346b0} |
| Wi-Fi Direct | {0407d24e-53de-4c9a-9ba1-9ced54641188} |
| DNS 服務探索 (DNS-SD) | {4526e8c1-8aac-4153-9b16-55e86ada0e54} |
| 服務點 | {d4bf61b3-442e-4ada-882d-fa7B70c832d9} |
| 網路印表機 (使用中目錄印表機) | {37aba761-2124-454c-8d82-c42962c2de2b} |
| Windows 立即連線 (WNC) | {4c1b1ef8-2f62-4b9f-9bc5-b21ab636138f} |
| WiGig Docks | {a277f3a5-8764-4f88-8045-4c5e962640b1} |
| HP 印表機的 Wi-Fi 布建 | {c85ef710-f344-4792-bb6d-85a4346f1e69} |
| Bluetooth | {e0cbf06c-cd8b-4647-bb8a-263b43f0f974} |
| 藍牙 LE | {bb7bb05e-5972-42b5-94fc-76eaa7084d49} |
| 網路相機 | {b8238652-b500-41eb-b4f3-4234f7f5ae99} |
進階查詢語法 (AQS) 範例
每種 AEP 類型都有一個屬性，您可以使用該屬性將列舉限制為特定通訊協定。 請記住，您可以在 AQS 篩選器中使用 OR 運算子來組合多個通訊協定。 以下是 AQS 篩選器字串的一些範例，示範如何查詢 AEP 裝置。
當 DeviceInformationKind 設定為 AsssociationEndpoint 時，此 AQS 查詢所有 UPnP AssociationEndpoint 物件。
System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
當 DeviceInformationKind 設定為 AsssociationEndpoint 時，此 AQS 查詢所有 UPnP 和 WSD AssociationEndpoint 物件。
System.Devices.Aep.ProtocolId:="{782232aa-a2f9-4993-971b-aedc551346b0}" OR
System.Devices.Aep.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
如果 DeviceInformationKind 設定為 AssociationEndpointService 時，此 AQS 查詢所有 UPnP AssociationEndpointService 物件。
System.Devices.AepService.ProtocolId:="{0e261de4-12f0-46e6-91ba-428607ccef64}"
當 DeviceInformationKind 設定為 AssociationEndpointContainer 時，此 AQS 會查詢 AssociationEndpointContainer 物件，但僅透過列舉 UPnP 通訊協定來尋找它們。 通常，列舉僅來自一種通訊協定的容器是沒有用的。 但是，透過將篩選器限制為可以探索到您裝置的通訊協定，這可能會很有用。
System.Devices.AepContainer.ProtocolIds:~~"{0e261de4-12f0-46e6-91ba-428607ccef64}"