RpcMgmtIsServerListening 함수(rpcdce.h)

RpcMgmtIsServerListening 함수는 서버가 원격 프로시저 호출을 수신 대기하는지 여부를 알려줍니다.

구문

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

매개 변수

Binding

원격 애플리케이션이 원격 프로시저 호출을 수신 대기하는지 여부를 확인하려면 해당 애플리케이션에 대한 서버 바인딩 핸들을 지정합니다. 사용자 고유의 (로컬) 애플리케이션이 원격 프로시저 호출을 수신 대기하는지 여부를 확인하려면 NULL 값을 지정합니다.

반환 값

값	의미
RPC_S_OK	원격 프로시저 호출을 수신 대기하는 서버입니다.
RPC_S_NOT_LISTENING	서버가 원격 프로시저 호출을 수신 대기하지 않거나 인터페이스가 자동 수신 대기 중입니다.
RPC_S_INVALID_BINDING	바인딩 핸들이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING	작업에 대한 잘못된 종류의 바인딩이었습니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

 

RpcMgmtIsServerListening 함수는 자동 수신 대기하지 않는 인터페이스에 대해서만 올바른 결과를 반환합니다. 서버 애플리케이션이 자동 수신 대기 중이고 RpcMgmtIsServerListening 함수를 호출하는 경우 RpcMgmtIsServerListening 은 RPC_SERVER_NOT_LISTENING 반환하지만 서버가 수신 대기 중일 수 있으며 후속 RPC 호출이 성공할 수 있습니다.

설명

애플리케이션은 RpcMgmtIsServerListening 함수를 호출하여Binding 매개 변수에 지정된 서버가 원격 프로시저 호출을 수신 대기하는지 여부를 확인합니다.

RpcMgmtIsServerListening 함수는 서버가 RpcServerListen을 호출한 경우 RPC_S_OK 값을 반환합니다.

이 함수가 성공하려면 서버에서 원격 프로시저 호출을 수신 대기해야 합니다. 서버가 수신 대기하지 않으면 함수가 실패합니다.

요구 사항

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

추가 정보

RpcEpResolveBinding

RpcServerListen