GetNamedPipeInfo 함수(namedpipeapi.h)

  • 아티클

지정된 명명된 파이프에 대한 정보를 검색합니다.

구문

BOOL GetNamedPipeInfo(
  [in]            HANDLE  hNamedPipe,
  [out, optional] LPDWORD lpFlags,
  [out, optional] LPDWORD lpOutBufferSize,
  [out, optional] LPDWORD lpInBufferSize,
  [out, optional] LPDWORD lpMaxInstances
);

매개 변수

[in] hNamedPipe

명명된 파이프 instance 대한 핸들입니다. 핸들은 읽기 전용 또는 읽기/쓰기 파이프에 대해 명명된 파이프에 대한 GENERIC_READ 액세스 권한이 있거나 쓰기 전용 파이프에 대한 GENERIC_WRITE 및 FILE_READ_ATTRIBUTES 액세스 권한이 있어야 합니다.

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

[out, optional] lpFlags

명명된 파이프의 형식을 수신하는 변수에 대한 포인터입니다. 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다. 그렇지 않으면 이 매개 변수는 다음 값 중 하나 이상이 될 수 있습니다.

값 의미
PIPE_CLIENT_END
0x00000000
 핸들은 명명된 파이프 instance 클라이언트 끝을 나타냅니다. 이것이 기본값입니다.
PIPE_SERVER_END
0x00000001
 핸들은 명명된 파이프 instance 서버 끝을 나타냅니다. 이 값을 지정하지 않으면 핸들은 명명된 파이프 instance 클라이언트 끝을 참조합니다.
PIPE_TYPE_BYTE
0x00000000
 명명된 파이프는 바이트 파이프입니다. 이것이 기본값입니다.
PIPE_TYPE_MESSAGE
0x00000004
 명명된 파이프는 메시지 파이프입니다. 이 값을 지정하지 않으면 파이프는 바이트 파이프입니다.

[out, optional] lpOutBufferSize

나가는 데이터의 버퍼 크기를 바이트 단위로 받는 변수에 대한 포인터입니다. 버퍼 크기가 0이면 필요에 따라 버퍼가 할당됩니다. 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[out, optional] lpInBufferSize

들어오는 데이터의 버퍼 크기를 바이트 단위로 받는 변수에 대한 포인터입니다. 버퍼 크기가 0이면 필요에 따라 버퍼가 할당됩니다. 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[out, optional] lpMaxInstances

만들 수 있는 최대 파이프 인스턴스 수를 수신하는 변수에 대한 포인터입니다. 변수가 PIPE_UNLIMITED_INSTANCES(255)로 설정된 경우 만들 수 있는 파이프 인스턴스 수는 시스템 리소스의 가용성에 의해서만 제한됩니다. 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

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

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

설명

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

요구 사항

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

참고 항목

CreateNamedPipe

GetNamedPipeHandleState

파이프 함수

파이프 개요