RPC_ENDPOINT_TEMPLATEW 구조체(rpcdce.h)

RPC_ENDPOINT_TEMPLATE 구조는 프로토콜 시퀀스 및 이름을 포함하여 RPC 인터페이스 그룹 서버 엔드포인트의 속성을 지정합니다.

구문

typedef struct {
  unsigned long Version;
  RPC_WSTR      ProtSeq;
  RPC_WSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEW, *PRPC_ENDPOINT_TEMPLATEW;

멤버

Version

이 필드는 예약되어 있으며 0으로 설정해야 합니다.

ProtSeq

RPC 런타임 라이브러리에 등록할 프로토콜 시퀀스의 문자열 식별자에 대한 포인터입니다. ncalrpc, ncacn_ip_tcp 및 ncacn_np만 지원됩니다. 이 값은 NULL이 아니어야 합니다.

Endpoint

Protseq 매개 변수에 지정된 프로토콜 시퀀스에 대한 바인딩을 만드는 데 사용할 엔드포인트 주소 정보에 대한 선택적 포인터입니다. 동적 엔드포인트를 사용하도록 NULL 을 지정합니다.

SecurityDescriptor

보안 하위 시스템에 대해 제공되는 선택적 매개 변수에 대한 포인터입니다. ncacn_np 및 ncalrpc 프로토콜 시퀀스에만 사용됩니다. 다른 모든 프로토콜 시퀀스는 이 매개 변수를 무시합니다. 서버를 안전하게 만들기 위해 엔드포인트에서 보안 설명자를 사용하지 않는 것이 좋습니다.

Backlog

ncacn_ip_tcp 프로토콜 시퀀스의 백로그 큐 길이입니다. 다른 모든 프로토콜 시퀀스는 이 매개 변수를 무시합니다. RPC_C_PROTSEQ_MAX_REQS_DEFAULT 사용하여 기본값을 지정합니다. 자세한 내용은 설명 부분을 참조하십시오.

설명

애플리케이션에서 백로그 에 제공된 값은 힌트일 뿐입니다. RPC 런타임 또는 Windows 소켓 공급자가 값을 재정의할 수 있습니다. 예를 들어 Windows XP 또는 Windows 2000 Professional에서는 값이 5로 제한됩니다. 5보다 큰 값은 무시되고 5는 대신 사용됩니다. Windows Server 2003 및 Windows 2000 Server에서는 값이 적용됩니다.

애플리케이션은 백로그에서 적절한 값을 전달하도록 주의해야 합니다. 서버, 고급 서버 또는 데이터 센터 서버의 값이 크면 페이징되지 않은 풀 메모리가 많이 사용될 수 있습니다. 너무 작은 값을 사용하면 백로그 큐가 소진될 경우 TCP RST가 TCP SYN 패킷을 서버에서 충족할 수 있으므로 불리합니다.

애플리케이션 개발자는 백로그에 대한 적절한 값을 결정할 때 메모리 공간과 확장성 요구 사항의 균형을 유지해야 합니다.

요구 사항

추가 정보

RpcServerInqBindings