GetMailslotInfo 함수(winbase.h)

지정된 mailslot에 대한 정보를 검색합니다.

구문

BOOL GetMailslotInfo(
  [in]            HANDLE  hMailslot,
  [out, optional] LPDWORD lpMaxMessageSize,
  [out, optional] LPDWORD lpNextSize,
  [out, optional] LPDWORD lpMessageCount,
  [out, optional] LPDWORD lpReadTimeout
);

매개 변수

[in] hMailslot

mailslot에 대한 핸들입니다. CreateMailslot 함수는 이 핸들을 만들어야 합니다.

[out, optional] lpMaxMessageSize

이 mailslot에 허용되는 최대 메시지 크기(바이트)입니다. 이 값은 mailslot을 만든 CreateMailslot 함수의 cbMaxMsg 매개 변수에 지정된 값보다 크거나 같을 수 있습니다. 이 매개 변수는 NULL일 수 있습니다.

[out, optional] lpNextSize

다음 메시지의 크기(바이트)입니다. 다음 값에는 특별한 의미가 있습니다.

값	의미
MAILSLOT_NO_MESSAGE ((DWORD)-1)	다음 메시지는 없습니다.

 

이 매개 변수는 NULL일 수 있습니다.

[out, optional] lpMessageCount

함수가 반환될 때 읽을 때까지 대기 중인 총 메시지 수입니다. 이 매개 변수는 NULL일 수 있습니다.

[out, optional] lpReadTimeout

읽기 작업은 시간 초과가 발생하기 전에 mailslot에 메시지를 쓸 때까지 대기할 수 있는 시간(밀리초)입니다. 이 매개 변수는 함수가 반환할 때 채워집니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

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

요구 사항

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

참고 항목

CreateMailslot

Mailslot 함수

Mailslots 개요

SetMailslotInfo