SetNamedPipeHandleState 함수(namedpipeapi.h)

지정된 명명된 파이프의 읽기 모드 및 차단 모드를 설정합니다. 지정된 핸들이 명명된 파이프의 클라이언트 끝에 있고 명명된 파이프 서버 프로세스가 원격 컴퓨터에 있는 경우 함수를 사용하여 로컬 버퍼링을 제어할 수도 있습니다.

구문

BOOL SetNamedPipeHandleState(
  [in]           HANDLE  hNamedPipe,
  [in, optional] LPDWORD lpMode,
  [in, optional] LPDWORD lpMaxCollectionCount,
  [in, optional] LPDWORD lpCollectDataTimeout
);

매개 변수

[in] hNamedPipe

명명된 파이프 instance 대한 핸들입니다. 이 매개 변수는 CreateNamedPipe 함수에서 반환된 파이프의 서버 끝이나 CreateFile 함수에서 반환한 파이프의 클라이언트 끝에 대한 핸들일 수 있습니다. 핸들은 쓰기 전용 또는 읽기/쓰기 파이프에 대해 명명된 파이프에 대한 GENERIC_WRITE 액세스 권한이 있거나 읽기 전용 파이프에 대한 GENERIC_READ 및 FILE_WRITE_ATTRIBUTES 액세스 권한이 있어야 합니다.

이 매개 변수는 CreatePipe 함수에서 반환한 익명 파이프에 대한 핸들일 수도 있습니다.

[in, optional] lpMode

새 파이프 모드입니다. 모드는 읽기 모드 플래그와 대기 모드 플래그의 조합입니다. 모드가 설정되지 않은 경우 이 매개 변수는 NULL 일 수 있습니다. 다음 모드 중 하나를 지정합니다.

다음 대기 모드 중 하나를 지정할 수 있습니다.

[in, optional] lpMaxCollectionCount

서버로 전송하기 전에 클라이언트 컴퓨터에서 수집된 최대 바이트 수입니다. 지정된 파이프 핸들이 명명된 파이프의 서버 끝에 있거나 클라이언트 및 서버 프로세스가 동일한 컴퓨터에 있는 경우 이 매개 변수는 NULL 이어야 합니다. 클라이언트 프로세스가 핸들을 만들 때 CreateFile 함수에서 FILE_FLAG_WRITE_THROUGH 플래그를 지정하는 경우 이 매개 변수는 무시됩니다. 컬렉션 수가 설정되지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[in, optional] lpCollectDataTimeout

원격 명명된 파이프가 네트워크를 통해 정보를 전송하기 전에 전달할 수 있는 최대 시간(밀리초)입니다. 지정된 파이프 핸들이 명명된 파이프의 서버 끝에 있거나 클라이언트 및 서버 프로세스가 동일한 컴퓨터에 있는 경우 이 매개 변수는 NULL 이어야 합니다. 클라이언트 프로세스가 핸들을 만들 때 CreateFile 함수에서 FILE_FLAG_WRITE_THROUGH 플래그를 지정한 경우 이 매개 변수는 무시됩니다. 컬렉션 수가 설정되지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

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

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

설명

Windows 10 버전 1709: 파이프는 앱 컨테이너 내에서만 지원됩니다. 즉, 한 UWP 프로세스에서 동일한 앱의 일부인 다른 UWP 프로세스까지 지원됩니다. 또한 명명된 파이프는 파이프 이름에 대한 구문을 \\.\pipe\LOCAL\ 사용해야 합니다.

예제

예제는 명명된 파이프 클라이언트를 참조하세요.

요구 사항

참고 항목

ConnectNamedPipe

CreateFile

CreateNamedPipe

GetNamedPipeHandleState

파이프 함수

파이프 개요

ReadFile

WriteFile