WWbemPathKeyList：：GetKey 方法 (wmiutils.h)

IWbemPathKeyList：：GetKey 方法會擷取密鑰的名稱或值。 索引鍵會從 0 (零) 編製索引，但索引鍵的順序並不重要。

語法

HRESULT GetKey(
  [in]      ULONG  uKeyIx,
  [in]      ULONG  uFlags,
  [in, out] ULONG  *puNameBufSize,
  [in, out] LPWSTR pszKeyName,
  [in, out] ULONG  *puKeyValBufSize,
  [in, out] LPVOID pKeyVal,
  [in, out] ULONG  *puApparentCimType
);

參數

[in] uKeyIx

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

[in] uFlags

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

[in, out] puNameBufSize

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

[in, out] pszKeyName

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

[in, out] puKeyValBufSize

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

[in, out] pKeyVal

要複製數據的緩衝區。

[in, out] puApparentCimType

設定為 CIM 類型的 long 指標。

傳回值

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

備註

建議的做法是呼叫這個方法、傳入緩衝區的 NULL 指標，並將其 size 參數設定為 0 (零) ，以判斷需要多少個緩衝區。 傳回時，緩衝區的大小參數會指出字串及其 NULL 終止符所需的緩衝區大小。 然後，您可以呼叫 方法來取得緩衝區值。

規格需求

另請參閱

IWbemPath

IWbemPathKeyList

IWbemPathKeyList：：GetKey2