다음을 통해 공유

ITypeLib::FindName 메서드(oaidl.h)

  • 아티클

형식 라이브러리에 들어 있는 형식 설명의 항목을 찾습니다. 형식 라이브러리에 이름이 있는지 빠르게 확인하는 데 사용할 수 있습니다.

구문

HRESULT FindName(
  [in, out] LPOLESTR  szNameBuf,
  [in]      ULONG     lHashVal,
  [out]     ITypeInfo **ppTInfo,
  [out]     MEMBERID  *rgMemId,
  [in, out] USHORT    *pcFound
);

매개 변수

[in, out] szNameBuf

검색할 이름입니다.

[in] lHashVal

LHashValOfNameSys 함수로 계산된 검색 속도를 높이기 위한 해시 값입니다. lHashVal = 0이면 값이 계산됩니다.

[out] ppTInfo

szNameBuf에 지정된 이름을 포함하는 형식 설명에 대한 포인터 배열입니다. 이 매개 변수는 null일 수 없습니다.

[out] rgMemId

찾은 항목의 배열입니다. rgMemId[i]는 ppTInfo[i]에서 지정한 형식 설명으로 인덱싱하는 MEMBERID입니다. 이 매개 변수는 null일 수 없습니다.

[in, out] pcFound

항목에서 찾을 인스턴스의 수를 나타냅니다. 예를 들어 *pcFound = 1을 호출하여 첫 번째 항목을 찾을 수 있습니다. 검색이 발견되면 중지됩니다.

종료할 때 발견한 인스턴스의 수를 알려 줍니다. *pcFound 의 in 및 out 값이 동일한 경우 이름을 포함하는 더 많은 형식 설명이 있을 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
S_ok
성공.
E_INVALIDARG
하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
메모리가 부족하여 작업을 완료할 수 없습니다.

설명

*pcFound = n을 전달하면 n(ptinfo, memid) 쌍에 대한 ppTInfo 및 rgMemId 배열에 충분한 공간이 있음을 나타냅니다. szNameBuf의 이름이 ppTInfo[i]의 형식 정보 이름인 경우 함수는 rgMemId[i]에서 MEMBERID_NIL 반환합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 oaidl.h

추가 정보

ITypeLib