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 포인터를 전달하고, 크기 매개 변수를 0으로 설정하여 버퍼가 얼마나 큰지 확인하는 것이 좋습니다. 반환 시 버퍼의 size 매개 변수는 문자열 및 해당 NULL 종결자에 필요한 버퍼의 크기를 나타냅니다. 그런 다음 메서드를 호출하여 버퍼 값을 가져올 수 있습니다.

요구 사항

추가 정보

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey2