尋找參考指定之索引鍵實例的關聯物件。
語法
MI_INLINE void MI_Session_ReferenceInstances(
[in] MI_Session *session,
MI_Uint32 flags,
[in, optional] MI_OperationOptions *options,
const MI_Char *namespaceName,
[in] const MI_Instance *instanceKey,
const MI_Char *resultClass,
const MI_Char *role,
MI_Boolean keysOnly,
[in, optional] MI_OperationCallbacks *callbacks,
[out] MI_Operation *operation
);
參數
[in] session
從 MI_Application_NewSession 傳回的會話句柄。
flags
運行時間類型資訊 (RTTI) 旗標。
[in, optional] options
選擇性 MI_OperationOptions 值，指定逾時等選項，以及如何控制 CIM 語意。 如果未傳送任何作業選項，請指定 Null 。
namespaceName
選擇性的 Null 終止字串，表示要執行作業的命名空間名稱。 如果未指定任何專案，伺服器會挑選預設值。 命名空間不能包含計算機名稱。 它只能以 /) 斜線字元分隔的命名空間名稱形式 (。 例如，下列是有效的 namespaceName 值： root/cimv2。
[in] instanceKey
MI_Instance，表示要啟動參考作業之實例的類別名稱和索引鍵。
resultClass
選擇性且以 Null 結尾的字串，表示限制結果集僅此關聯類別的值。 如果不需要篩選，請指定 Null 。
role
選擇性且以 Null 結束的字串，表示指定關聯類別中要用來參考索引鍵類別的屬性名稱的值。
keysOnly
布爾值 ，其中MI_TRUE 表示只擷取實例索引鍵。 否則，將會擷取所有屬性。
[in, optional] callbacks
選擇性 MI_OperationCallbacks 結構，定義接收實例結果和 CIM 語意的操作回呼。 若要以異步方式執行作業，必須指定結構的 instanceResult 回呼成員。 如果未指定該結構成員，客戶端必須呼叫 MI_Operation_GetInstance 函式來擷取結果。
[out] operation
傳回的作業句柄，必須在完成之後，透過 MI_Operation_Close 關閉 。 在完成之前 呼叫MI_Operation_Cancel 會導致作業關閉。 您可以從任何作業呼叫MI_Operation_Close和MI_Operation_Cancel。
傳回值
無
備註
關聯是兩個 對象之間的關聯性。 它以包含兩個屬性的第三個 物件表示，每個物件都是這兩個相關物件的其中一個參考。 role 參數是關聯對象的參考屬性，指向所關聯的物件。
此函式與 MI_Session_AssociatorInstances 函式之間的差異在於，此函式會尋找關聯物件本身，而 MI_Session_AssociatorInstances 函式會尋找與索引鍵對象相關聯的實例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | Windows |
| 標頭 | mi.h |
| 可轉散發套件 | windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 Windows Management Framework 3.0 |