IShellApp::GetAppInfo 메서드(shappmgr.h)

아티클
03/05/2024

애플리케이션에 대한 일반 정보를 가져옵니다.

구문

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

매개 변수

[out] pai

형식: APPINFODATA*

애플리케이션 정보를 반환하는 APPINFODATA 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

참고 제어판 프로그램 추가/제거는 APPINFODATA 구조체의 cbSize 및 dwMask 멤버를 설정합니다.

구현은 APPINFODATA의 크기와 비교하여 cbSize의 유효성을 검사해야 합니다. cbSize가 APPINFODATA의 크기와 같지 않으면 이 메서드는 E_FAIL 같은 COM 오류 값을 반환해야 합니다.

제어판 프로그램 추가/제거는 APPINFODATA 구조체의 dwMask 멤버를 설정하여 AIM_DISPLAYNAME 반환하고 AIM_SUPPORTURL 나타냅니다. APPINFODATA에서 반환하는 각 값에 대해 해당 비트를 dwMask로 설정해야 합니다. 다른 모든 비트를 지워야 합니다.

예제

다음은 dwMask 비트를 사용하는 방법의 샘플입니다.

HRESULT CPubApp::GetAppInfo(APPINFODATA *pData)
{
    if (sizeof(APPINFODATA) != pData->cbSize)
        return E_FAIL;

    // First save off the mask of requested data items.

    const DWORD dwMask = pData->dwMask;

    // Zero-out the mask.  Bits will be set as items are obtained. 

    pData->dwMask = 0;

    // Call an internal function that obtains data and sets
    // bits in pData->dwMask for each item obtained.

    return get_app_info_data(pData, dwMask);

}

요구 사항

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