CoGetCallerTID 함수(combaseapi.h)

호출자 스레드의 아파트 ID를 포함하는 DWORD 에 대한 포인터를 반환합니다.

구문

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

매개 변수

[out] lpdwTID

호출자 스레드의 아파트 ID를 받습니다. STA(단일 스레드 아파트)의 경우 현재 스레드 ID입니다. MTA(다중 스레드 아파트)의 경우 값은 0입니다. 중립 아파트(NA)의 경우 값은 -1입니다.

반환 값

이 함수는 다음 값을 반환할 수 있습니다.

반환 코드	설명
S_TRUE	호출자의 스레드 ID가 설정되고 호출자가 동일한 프로세스에 있습니다.
S_FALSE	호출자의 스레드 ID가 설정되고 호출자가 다른 프로세스에 있습니다.
E_OUTOFMEMORY	호출자의 스레드 ID가 설정되지 않았습니다.

설명

호출자가 동일한 컴퓨터에서 실행되고 있지 않으면 이 함수는 아파트 ID를 반환하지 않으며 반환 값은 S_FALSE.

이 API에서 반환된 정보가 변조되지 않는다는 보장은 없으므로 보안 결정을 내리기 위해 반환된 ID를 사용하지 마세요. ID는 로깅 및 진단 목적으로만 사용할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	combaseapi.h(Objbase.h 포함)
라이브러리	Ole32.lib
DLL	Ole32.dll