DevCreateObjectQueryFromIdEx 函式 （devquery.h）
建立裝置查詢，以根據指定的查詢參數、擴充參數和對象標識符來擷取屬性。
語法
HRESULT DevCreateObjectQueryFromIdEx(
[in] DEV_OBJECT_TYPE ObjectType,
[in] PCWSTR pszObjectId,
[in] ULONG QueryFlags,
[in] ULONG cRequestedProperties,
[in, optional] const DEVPROPCOMPKEY *pRequestedProperties,
[in] ULONG cFilterExpressionCount,
[in, optional] const DEVPROP_FILTER_EXPRESSION *pFilter,
[in] ULONG cExtendedParameterCount,
[in, optional] const DEV_QUERY_PARAMETER *pExtendedParameters,
[in] PDEV_QUERY_RESULT_CALLBACK pCallback,
[in, optional] PVOID pContext,
[out] PHDEVQUERY phDevQuery
);
參數
[in] ObjectType
來自 DEV_OBJECT_TYPE 列舉的值，決定此查詢應該運作的物件類型。
[in] pszObjectId
查詢應該操作之特定物件的字串標識碼。
[in] QueryFlags
使用位 OR 運算結合 DEV_QUERY_FLAGS 值的組合。
[in] cRequestedProperties
pRequestedProperties中提供的 DEVPROPCOMPKEY 結構數目。 如果指定 DevQueryFlagAllProperties，則必須將此值設定為 0。
[in, optional] pRequestedProperties
選擇性地提供
如果在 QueryFlags中指定了 DevQueryFlagUpdateResults，則查詢會在查詢結果集中的任何物件有任何這些屬性的值變更時收到通知。
DEVPROPCOMPKEY 結構的 LocaleName 字段會被忽略，而且必須設定為 NULL。
如果 cRequestedProperties 為 0，這必須是 NULL。
[in] cFilterExpressionCount
pFilter中提供的 DEVPROP_FILTER_EXPRESSION 結構數目。
[in, optional] pFilter
選擇性地提供一個 DEVPROP_FILTER_EXPRESSION 結構的數位，以指定哪些對象應該是查詢結果集一部分的篩選準則。 如果 cFilterExpressionCount 為 0，這必須是 NULL。
[in] cExtendedParameterCount
保留給系統使用量。 必須設定為 0。
[in, optional] pExtendedParameters
保留給系統使用量。 必須設定為 NULL。
[in] pCallback
應該傳送此查詢結果的 PDEV_QUERY_RESULT_CALLBACK 回呼函式。
[in, optional] pContext
呼叫端提供的內容。 此值會傳遞至未修改的回調函式。
[out] phDevQuery
接收代表查詢之句柄的指標。 如果 指定 DevQueryFlagsUpdateResults，則查詢將會收到更新，直到句柄關閉為止。 呼叫 DevCloseObjectQuery 關閉此句柄以停止查詢。
傳回值
如果成功建立查詢，則會傳回S_OK;否則為適當的錯誤值。
言論
當用戶端想要擷取特定物件身分識別的相關數據時，請使用此函式，而不是使用篩選條件 DevCreateObjectQuery。 此函式更有效率。
如需詳細資訊，請參閱 DevCreateObjectQuery的一節，這也適用於此函式。 如需建立裝置查詢以根據指定的查詢參數和對象識別符擷取屬性的範例，請參閱 DevCreateObjectQueryFromId。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1809 |
| 支援的最低伺服器 | Windows Server 2019 |
| 標頭 | devquery.h |
| 連結庫 | Onecore.lib |
| DLL | Cfgmgr32.dll |