iWbemPathKeyList：：GetKey2 方法 (wmiutils.h)

IWbemPathKeyList：：GetKey2 方法會擷取密鑰名稱或值，並將值當做 VARIANT 傳回。 索引鍵會從 0 (零) 編製索引，但索引鍵順序並不重要。

語法

HRESULT GetKey2(
  [in]      ULONG   uKeyIx,
  [in]      ULONG   uFlags,
  [in, out] ULONG   *puNameBufSize,
  [out]     LPWSTR  pszKeyName,
  [out]     VARIANT *pKeyValue,
  [out]     ULONG   *puApparentCimType
);

參數

[in] uKeyIx

索引鍵索引從 0 開始， (零) 。

[in] uFlags

保留的。 必須是 0 (零) 。

[in, out] puNameBufSize

呼叫端會將此參數設定為名稱緩衝區可以保存的字元數。 成功時，這會設定為複製到緩衝區的字元數，包括終止 的NULL。

[out] pszKeyName

複製名稱的緩衝區。 因為並非所有索引鍵都有名稱，所以隱含索引鍵的此參數值為 NULL 。

[out] pKeyValue

包含索引鍵值的變體指標。

[out] puApparentCimType

設定為 CIM 類型的長整數指標。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。

備註

這個方法可用來判斷緩衝區需要多少大，方法是傳入緩衝區的 NULL 指標，並將其 size 參數設定為 0 (零) 。 傳回時，緩衝區大小參數會指出字串及其 NULL 終止符所需的大小緩衝區。

規格需求

另請參閱

IWbemPath

IWbemPathKeyList

IWbemPathKeyList：：GetKey