Share via

SetFileCompletionNotificationModes 함수(winbase.h)

  • 아티클

파일 핸들의 알림 모드를 설정하여 완료 알림이 지정된 파일에 대해 작동하는 방식을 지정할 수 있습니다.

구문

BOOL SetFileCompletionNotificationModes(
  [in] HANDLE FileHandle,
  [in] UCHAR  Flags
);

매개 변수

[in] FileHandle

파일에 대한 핸들입니다.

[in] Flags

설정할 모드입니다. 하나 이상의 모드를 동시에 설정할 수 있습니다. 그러나 파일 핸들에 대해 모드를 설정한 후에는 제거할 수 없습니다.

값 의미
FILE_SKIP_COMPLETION_PORT_ON_SUCCESS
0x1
 다음 세 가지 조건이 true인 경우 I/O 관리자는 일반적으로 포트에 대한 완료 항목을 큐에 대기하지 않습니다. 조건은 다음과 같습니다.
  • 완료 포트는 파일 핸들과 연결됩니다.
  • 파일이 비동기 I/O용으로 열립니다.
  • 요청은 ERROR_PENDING 반환하지 않고 즉시 성공을 반환합니다.

FileHandle 매개 변수가 소켓인 경우 이 모드는 IFS(설치 가능한 파일 시스템) 핸들을 반환하는 LSP(계층화된 서비스 공급자)와만 호환됩니다. 비 IFS LSP가 설치되어 있는지 여부를 감지하려면 WSAEnumProtocols 함수를 사용하고 반환된 각 WSAPROTOCOL_INFO 구조체에서 dwServiceFlag1 멤버를 검사합니다. XP1_IFS_HANDLES(0x20000) 비트가 지워지면 지정된 LSP가 IFS LSP가 아닙니다. IFS LSP가 아닌 공급업체는 WFP( Windows 필터링 플랫폼 )로 마이그레이션하는 것이 좋습니다.
FILE_SKIP_SET_EVENT_ON_HANDLE
0x2
 요청이 성공 코드와 함께 반환되거나 반환된 오류가 ERROR_PENDING 호출되는 함수가 동기 함수가 아닌 경우 I/O 관리자가 파일 개체에 대한 이벤트를 설정하지 않습니다.

요청에 대해 명시적 이벤트가 제공되면 여전히 신호가 전송됩니다.

반환 값

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 매크로를 0x0600 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 Yes
SMB 3.0 TFO(투명 장애 조치(failover)) Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 Yes
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes
ReFS(Resilient File System) Yes

요구 사항

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

참고 항목

파일 관리 함수