IWbemPathKeyList::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 (ゼロ) に設定することで、バッファーが必要な大きさを判断することをお勧めします。 返されると、バッファーの size パラメーターは、文字列とその NULL 終端記号に必要なバッファーの大きさを示します。 その後、 メソッドを呼び出してバッファー値を取得できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wmiutils.h |
| Library | Wbemuuid.lib |
| [DLL] | Wmiutils.dll |