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 (ゼロ) に設定することで、バッファーが必要な大きさを判断できます。 返された場合、buffer size パラメーターは、文字列とその NULL ターミネータに必要なサイズ バッファーを示します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wmiutils.h |
| Library | Wbemuuid.lib |
| [DLL] | Wmiutils.dll |