IQueryInfo::GetInfoTip 메서드(shlobj_core.h)

항목에 대한 정보 팁 텍스트를 가져옵니다.

구문

HRESULT GetInfoTip(
        DWORD dwFlags,
  [out] PWSTR *ppwszTip
);

매개 변수

dwFlags

형식:DWORD

정보 팁 텍스트를 검색할 항목의 처리를 지시하는 플래그입니다. 이 값은 일반적으로 0(QITIPF_DEFAULT)입니다. 다음 값이 인식됩니다.

QITIPF_DEFAULT(0x00000000)

특별한 처리가 없습니다.

QITIPF_USENAME(0x00000001)

정보 팁 텍스트가 아닌 ppwszTip 에 항목의 이름을 입력합니다.

QITIPF_LINKNOTARGET(0x00000002)

항목이 바로 가기인 경우 대상이 아닌 바로 가기의 정보 팁 텍스트를 검색합니다.

QITIPF_LINKUSETARGET(0x00000004)

항목이 바로 가기인 경우 바로 가기 대상의 정보 팁 텍스트를 검색합니다.

QITIPF_USESLOWTIP(0x00000008)

전체 네임스페이스에서 정보를 검색합니다. 이 값은 응답 시간이 지연될 수 있습니다.

QITIPF_SINGLELINE(0x00000010)

Windows Vista 이상. 정보 팁을 한 줄에 배치합니다.

[out] ppwszTip

형식: PWSTR*

이 메서드가 성공적으로 반환될 때 팁 문자열 포인터를 수신하는 유니코드 문자열 포인터의 주소입니다. 이 메서드를 구현하는 애플리케이션은 CoTaskMemAlloc을 호출하여 ppwszTip에 대한 메모리를 할당해야 합니다. 호출하는 애플리케이션은 더 이상 필요하지 않을 때 메모리를 해제하려면 CoTaskMemFree 를 호출해야 합니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK 반환합니다. 정보 팁 텍스트를 사용할 수 없는 경우 ppwszTip 이 NULL로 설정됩니다. 그렇지 않으면 COM에서 정의한 오류 값을 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h
DLL	Shell32.dll(버전 4.71 이상)

추가 정보

IQueryInfo