RPC_BINDING_HANDLE_TEMPLATE_V1_A 구조체(rpcdce.h)

RPC_BINDING_HANDLE_TEMPLATE_V1 구조에는 RPC 바인딩 핸들을 만드는 기본 옵션이 포함되어 있습니다.

구문

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_A {
  unsigned long Version;
  unsigned long Flags;
  unsigned long ProtocolSequence;
  unsigned char *NetworkAddress;
  unsigned char *StringEndpoint;
  union {
    unsigned char *Reserved;
  } u1;
  UUID          ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_A, *PRPC_BINDING_HANDLE_TEMPLATE_V1_A;

멤버

Version

이 구조체의 버전입니다. RPC_BINDING_HANDLE_TEMPLATE_V1 경우 1로 설정해야 합니다.

Flags

RPC 템플릿의 특정 속성을 설명하는 값에 플래그를 지정합니다.

값	의미
RPC_BHT_OBJECT_UUID_VALID	ObjectUuid 멤버에는 유효한 값이 포함됩니다. 이 플래그를 설정하지 않으면 ObjectUuid 멤버에 유효한 UUID가 포함되지 않습니다.

ProtocolSequence

이 바인딩 핸들과 연결된 프로토콜 시퀀스 ID입니다. 다음 값 중 하나일 수 있습니다.

• RPC_PROTSEQ_LRPC - 로컬 RPC를 지정합니다.
• RPC_PROTSEQ_TCP - TCP/IP를 통해 RPC를 지정합니다.
• RPC_PROTSEQ_NMP - 명명된 파이프에 대한 RPC를 지정합니다.
• RPC_PROTSEQ_HTTP - HTTP를 통한 RPC를 지정합니다.

NetworkAddress

바인딩할 네트워크 주소의 문자열 표현에 대한 포인터입니다.

StringEndpoint

바인딩할 엔드포인트의 문자열 표현에 대한 포인터입니다. 동적 엔드포인트를 사용하는 경우 이 멤버를 NULL로 설정합니다. 엔드포인트가 확인되면 RpcBindingToStringBinding을 사용하여 가져옵니다.

u1

u1.Reserved

예약되어 있습니다. 이 멤버는 NULL로 설정해야 합니다.

ObjectUuid

원격 개체의 UUID입니다. 이 UUID의 의미 체계는 문자열 바인딩의 의미 체계와 동일합니다. 바인딩 핸들을 만든 후 RpcBindingSetObject를 호출하여 필요에 따라 UUID를 변경합니다.

설명

빠른 바인딩 핸들은 RpcBindingReset 호출 중에 처리되는 방식의 "클래식" 바인딩 핸들과 약간 다릅니다. RpcBindingReset 은 정적 빠른 바인딩 핸들에 대한 no-op 호출입니다. 그러나 클래식 바인딩 핸들의 경우 RpcBindingReset 은 정적 바인딩 핸들을 동적 바인딩 핸들로 변환하여 이전 버전과의 호환성을 유지합니다.

다음 표에서는 RpcBindingReset 및 RpcEpResolveBinding과 관련된 정적 및 동적 바인딩 핸들의 동작을 보여 줍니다.

엔드포인트 유형	정적		동적
바인딩 핸들 형식	빠름	클래식	빠름	클래식
RpcBindingReset	작업 없음	동적으로 변환	해결된 엔드포인트가 있는 경우 제거합니다.	해결된 엔드포인트가 있는 경우 제거합니다.
RpcEpResolveBinding	작업 없음	작업 없음	이전에 확인되지 않은 경우 엔드포인트를 확인합니다.	이전에 확인되지 않은 경우 엔드포인트를 확인합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	rpcdce.h(Rpc.h 포함)

추가 정보

RPC_BINDING_HANDLE

RpcBindingBind

RpcBinding만들기