RpcServerInqCallAttributesA 함수(rpcasync.h)

RpcServerInqCallAttributes 함수는 클라이언트 보안 컨텍스트 특성을 가져오는 RPC 서버 호출입니다.

구문

RPC_STATUS RpcServerInqCallAttributesA(
  [in]      RPC_BINDING_HANDLE ClientBinding,
  [in, out] void               *RpcCallAttributes
);

매개 변수

[in] ClientBinding

선택 사항입니다. 서버 루틴 내에서 명시적 바인딩의 경우 ClientBinding 은 관리자 루틴이 호출된 바인딩 핸들입니다. 설명 부분을 참조하세요.

[in, out] RpcCallAttributes

호출 특성을 수신하는 RPC_CALL_ATTRIBUTES_V2 구조체입니다.

반환 값

성공하면 RPC_S_OK 반환하고 RpcCallAttributes 가 채워집니다. ERROR_MORE_DATA 반환되면 RpcCallAttributes 의 하나 이상의 필드 길이가 부족하여 채울 수 없습니다. ERROR_MORE_DATA 처리에 대한 자세한 내용은 RPC_CALL_ATTRIBUTES_V2 설명을 참조하세요.

실패하면 RpcCallAttributes 의 내용이 정의되지 않으며 RPC에서 부분적으로 수정할 수 있습니다.

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

 

설명

RpcServerInqCallAttributes 함수는 버전 관리 체계를 사용하여 접미사 식별자를 사용하여 새 함수를 도입하지 않고도 새 기능을 통합합니다. 예를 들어 헤더에서 간단한 #define 식별되는 두 번째 버전의 RPC_CALL_ATTRIBUTES_V2 RpcServerInqCallAttributesEx라는 함수를 해제하지 않고도 RpcServerInqCallAttributes 함수의 이후 버전에 기본 제공되는 새 기능을 용이하게 하는 새 멤버를 추가할 수 있습니다.

RpcServerInqCallAttributes 함수가 서버 루틴 외부에서 호출되고 함수 호출이 비동기 RPC 호출에 대한 보안 컨텍스트 특성을 쿼리하는 경우 비동기 핸들에서 RpcAsyncGetCallHandle 함수를 호출하여 ClientBinding을 검색할 수 있습니다.

RpcServerInqCallAttributes 함수는 ncadg_*와 같은 데이터그램 프로토콜 시퀀스에 대해 지원되지 않습니다. 데이터그램 프로토콜 시퀀스에서 실행되는 호출에서 호출되면 RPC_S_CANNOT_SUPPORT 반환됩니다.

RpcServerInqCallAttributes 함수는 스레드로부터 안전합니다.

예제

RPC_CALL_ATTRIBUTES CallAttributes;  // this maps to RPC_CALL_ATTRIBUTES_V1

memset(&CallAttributes, 0, sizeof(CallAttributes));
CallAttributes.Version = RPC_CALL_ATTRIBUTES_VERSION;    // maps to 1
CallAttributes.Flags = ;//....
Status = RpcServerInqCallAttributes(0, &ClientContextAttributes);

참고

rpcasync.h 헤더는 RpcServerInqCallAttributes를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

RPC_CALL_ATTRIBUTES_V2

RpcAsyncGetCallHandle