FlsSetValue 함수(fibersapi.h)

지정된 FLS 인덱스에 대한 호출 파이버의 FLS(파이버 로컬 스토리지) 슬롯에 값을 저장합니다. 각 파이버에는 각 FLS 인덱스에 대한 자체 슬롯이 있습니다.

구문

BOOL FlsSetValue(
  [in]           DWORD dwFlsIndex,
  [in, optional] PVOID lpFlsData
);

매개 변수

[in] dwFlsIndex

FlsAlloc 함수에 의해 할당된 FLS 인덱스입니다.

[in, optional] lpFlsData

호출 파이버의 FLS 슬롯에 저장할 값입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	인덱스가 범위에 없습니다.
ERROR_NO_MEMORY	FLS 배열이 할당되지 않았습니다.

설명

FLS 인덱스는 일반적으로 프로세스 또는 DLL 초기화 중에 FlsAlloc 함수에 의해 할당됩니다. FLS 인덱스가 할당된 후 프로세스의 각 파이버가 이를 사용하여 해당 인덱스에 대한 자체 FLS 슬롯에 액세스할 수 있습니다. 스레드는 FlsSetValue 호출에서 FLS 인덱스를 지정하여 값을 슬롯에 저장합니다. 스레드는 저장된 값을 검색하기 위해 FlsGetValue에 대한 후속 호출에서 동일한 인덱스를 지정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	fibersapi.h
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

섬유

FlsAlloc

FlsGetValue

프로세스 및 스레드 함수