TF_GetThreadMgr 함수(msctf.h)

TF_GetThreadMgr 함수는 호출 스레드 내에서 이전에 만든 스레드 관리자 개체의 복사본을 가져옵니다.

구문

HRESULT TF_GetThreadMgr(
  [out] ITfThreadMgr **pptim
);

매개 변수

[out] pptim

스레드 관리자 개체를 수신하는 ITfThreadMgr 인터페이스 포인터에 대한 포인터입니다. 호출 스레드 내에 스레드 관리자가 만들어지지 않으면 NULL 이 수신됩니다.

반환 값

설명

호출 스레드 내에 스레드 관리자가 만들어지지 않으면 이 함수는 pptim 을 NULL 로 설정하고 S_OK 반환합니다. 따라서 pptim을 사용하기 전에 함수가 성공했고 pptim이 NULL이 아닌지 확인해야 합니다.

예제

이 함수를 정의하는 가져오기 라이브러리는 사용할 수 없으므로 LoadLibrary 및 GetProcAddress를 사용하여 이 함수에 대한 포인터를 수동으로 가져와야 합니다. 다음 코드 예제에서는 이 작업을 수행하는 방법을 보여 줍니다.

다음 예제에서는 이전에 만든 스레드 관리자 개체의 복사본을 가져오려고 하는 함수를 보여 줍니다. 호출 스레드 내에 스레드 관리자 개체가 없으면 함수가 하나를 만듭니다.

typedef HRESULT (WINAPI *PTF_GETTHREADMGR)(ITfThreadMgr **pptim);

HRESULT GetThreadMgr(ITfThreadMgr **pptm)
{
    HRESULT hr = E_FAIL;
    HMODULE hMSCTF = LoadLibrary(TEXT("msctf.dll"));
    ITfThreadMgr *pThreadMgr = NULL;

    if(hMSCTF == NULL)
    {
        //Error loading module -- fail as securely as possible 
    }

    else
    {
        PTF_GETTHREADMGR pfnGetThreadMgr;
    
        pfnGetThreadMgr = (PTF_GETTHREADMGR)GetProcAddress(hMSCTF, "TF_GetThreadMgr");

        if(pfnGetThreadMgr)
        {
            hr = (*pfnGetThreadMgr)(&pThreadMgr);
        }
        
        FreeLibrary(hMSCTF);
    }

    //If no object could be obtained, try to create one. 
    if(NULL == pThreadMgr)
    {
        //CoInitialize or OleInitialize must already have been called. 
        hr = CoCreateInstance(  CLSID_TF_ThreadMgr, 
                                NULL, 
                                CLSCTX_INPROC_SERVER, 
                                IID_ITfThreadMgr, 
                                (void**)&pThreadMgr);
    }

    *pptm = pThreadMgr;

    return hr;
}

요구 사항

추가 정보

GetProcAddress

ITfThreadMgr

LoadLibrary