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 일 수 있습니다. 그렇지 않으면 이 매개 변수는 다음 값 중 하나 이상이 될 수 있습니다.
[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 |