CoGetCallerTID 함수(combaseapi.h)
호출자 스레드의 아파트 ID를 포함하는 DWORD 에 대한 포인터를 반환합니다.
구문
HRESULT CoGetCallerTID(
[out] LPDWORD lpdwTID
);
매개 변수
[out] lpdwTID
호출자 스레드의 아파트 ID를 받습니다. STA(단일 스레드 아파트)의 경우 현재 스레드 ID입니다. MTA(다중 스레드 아파트)의 경우 값은 0입니다. 중립 아파트(NA)의 경우 값은 -1입니다.
반환 값
이 함수는 다음 값을 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
호출자의 스레드 ID가 설정되고 호출자가 동일한 프로세스에 있습니다. |
|
호출자의 스레드 ID가 설정되고 호출자가 다른 프로세스에 있습니다. |
|
호출자의 스레드 ID가 설정되지 않았습니다. |
설명
호출자가 동일한 컴퓨터에서 실행되고 있지 않으면 이 함수는 아파트 ID를 반환하지 않으며 반환 값은 S_FALSE.
이 API에서 반환된 정보가 변조되지 않는다는 보장은 없으므로 보안 결정을 내리기 위해 반환된 ID를 사용하지 마세요. ID는 로깅 및 진단 목적으로만 사용할 수 있습니다.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | combaseapi.h(Objbase.h 포함) |
라이브러리 | Ole32.lib |
DLL | Ole32.dll |