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 終止符所需的緩衝區大小。 然後,您可以呼叫 方法來取得緩衝區值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wmiutils.h |
程式庫 | Wbemuuid.lib |
Dll | Wmiutils.dll |