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 이상) |