Share via

PostQueuedCompletionStatus 함수

  • 아티클

I/O 완료 패킷을 I/O 완료 포트에 게시합니다.

구문

BOOL WINAPI PostQueuedCompletionStatus(
  _In_     HANDLE       CompletionPort,
  _In_     DWORD        dwNumberOfBytesTransferred,
  _In_     ULONG_PTR    dwCompletionKey,
  _In_opt_ LPOVERLAPPED lpOverlapped
);

매개 변수

CompletionPort [in]

I/O 완료 패킷을 게시할 I/O 완료 포트에 대한 핸들입니다.

dwNumberOfBytesTransferred [in]

GetQueuedCompletionStatus 함수의 lpNumberOfBytesTransferred 매개 변수를 통해 반환되는 값입니다.

dwCompletionKey [in]

GetQueuedCompletionStatus 함수의 lpCompletionKey 매개 변수를 통해 반환되는 값입니다.

lpOverlapped [in, optional]

GetQueuedCompletionStatus 함수의 lpOverlapped 매개 변수를 통해 반환되는 값입니다.

반환 값

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

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

설명

I/O 완료 패킷은 GetQueuedCompletionStatus 함수에 대한 미해결 호출을 충족합니다. 이 함수는 PostQueuedCompletionStatus 호출의 두 번째, 세 번째 및 네 번째 매개 변수로 전달된 세 개의 값을 반환합니다. 시스템은 이러한 값을 사용하거나 유효성을 검사하지 않습니다. 특히 lpOverlapped 매개 변수는 OVERLAPPED 구조를 가리킬 필요가 없습니다.

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)
 예

CsvF는 압축된 파일에 대해 리디렉션된 IO를 수행합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱 | UWP 앱]
헤더
IoAPI.h(Windows.h 포함);
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP의 WinBase.h(Windows.h 포함)
라이브러리
Kernel32.lib
DLL
Kernel32.dll

참고 항목

CreateIoCompletionPort

파일 관리 함수

GetQueuedCompletionStatus

OVERLAPPED