TlsFree 함수(processthreadsapi.h)

아티클
02/07/2024

TLS(스레드 로컬 스토리지) 인덱스를 해제하여 다시 사용할 수 있도록 합니다.

구문

BOOL TlsFree(
  [in] DWORD dwTlsIndex
);

매개 변수

[in] dwTlsIndex

TlsAlloc 함수에 의해 할당된 TLS 인덱스입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

Windows Phone 8.1: 이 함수는 Windows Phone 8.1 이상에서 Windows Phone 스토어 앱에서 지원됩니다. Windows Phone 스토어 앱이 이 함수를 호출하면 FlsFree에 대한 인라인 호출로 바뀝니다. 함수 설명서는 FlsFree 를 참조하세요.

Windows 8.1, Windows Server 2012 R2 및 Windows 10 버전 1507: 이 함수는 Windows 8.1, Windows Server 2012 R2 및 Windows 10 버전의 Windows 스토어 앱에서 지원됩니다. 1507. Windows 스토어 앱이 이 함수를 호출하면 FlsFree에 대한 인라인 호출로 바뀝니다. 함수 설명서는 FlsFree 를 참조하세요.

Windows 10 버전 1511 및 Windows 10 버전 1607: 이 함수는 UWP(유니버설 Windows 플랫폼) 앱에서 완전히 지원되며 더 이상 FlsFree에 대한 인라인 호출로 대체되지 않습니다.

프로세스의 스레드가 메모리를 할당하고 TLS 슬롯에 메모리에 대한 포인터를 저장한 경우 TlsFree를 호출하기 전에 메모리를 해제해야 합니다. TlsFree 함수는 주소가 TLS 인덱스와 연결된 TLS 슬롯에 저장된 메모리 블록을 해제하지 않습니다. DLL은 DLL_PROCESS_DETACH 동안에만 이 함수를 호출합니다(전혀 없는 경우).

자세한 내용은 스레드 로컬 스토리지를 참조하세요.

예제

예제는 스레드 로컬 스토리지 사용 또는 Dynamic-Link 라이브러리에서 스레드 로컬 스토리지 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	processthreadsapi.h(Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2의 Windows.h 포함)
라이브러리	Kernel32.lib; Windows Phone 8.1의 WindowsPhoneCore.lib
DLL	Windows Phone 8.1의 KernelBase.dll; Kernel32.dll