RpcBindingInqAuthInfoExA 함수(rpcdce.h)

  • 아티클

RpcBindingInqAuthInfoEx 함수는 바인딩 핸들에서 인증, 권한 부여 및 보안 서비스 품질 정보를 반환합니다.

구문

RPC_STATUS RpcBindingInqAuthInfoExA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

매개 변수

Binding

인증 및 권한 부여 정보가 반환되는 서버 바인딩 핸들입니다.

ServerPrincName

바인딩에서 참조되는 서버의 예상 보안 주체 이름에 대한 포인터에 대한 포인터를 반환 합니다. 반환된 이름 및 해당 구문의 콘텐츠는 사용 중인 인증 서비스에 의해 정의됩니다.

RpcBindingInqAuthInfoEx가 ServerPrincName 매개 변수를 반환하지 못하도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출하지 않습니다.

AuthnLevel

바인딩을 사용하여 수행한 원격 프로시저 호출에 사용되는 인증 수준으로 설정된 포인터를 반환 합니다. RPC 지원 인증 수준 목록은 인증 수준 상수를 참조하세요. 함수가 AuthnLevel 매개 변수를 반환하지 못하도록 null 값을 지정합니다.

AuthnLevel 매개 변수에 반환된 수준은 클라이언트가 RpcBindingSetAuthInfoEx 함수를 호출할 때 지정된 수준과 다를 수 있습니다. 이 불일치는 RPC 런타임 라이브러리가 클라이언트에서 지정한 인증 수준을 지원하지 않고 다음 상위 인증 수준으로 자동으로 업그레이드될 때 발생합니다.

AuthnSvc

Binding을 사용하여 수행한 원격 프로시저 호출에 대해 지정된 인증 서비스에 대한 포인터 집합을 반환 합니다. RPC 지원 인증 서비스 목록은 Authentication-Service 상수를 참조하세요.

RpcBindingInqAuthInfoEx가 AuthnSvc 매개 변수를 반환하지 못하도록 null 값을 지정합니다.

AuthIdentity

바인딩을 사용하여 수행한 원격 프로시저 호출에 대해 지정된 클라이언트의 인증 및 권한 부여 자격 증명을 포함하는 데이터 구조에 대한 핸들에 대한 포인터를 반환 합니다.

RpcBindingInqAuthInfoEx가 AuthIdentity 매개 변수를 반환하지 못하도록 null 값을 지정합니다.

AuthzSvc

바인딩에서 원격 프로시저를 호출한 클라이언트 애플리케이션에서 요청한 권한 부여 서비스에 대한 포인터 집합을 반환 합니다. RPC 지원 인증 서비스 목록은 Authentication-Service 상수를 참조하세요.

RpcBindingInqAuthInfoEx가 AuthzSvc 매개 변수를 반환하지 못하도록 null 값을 지정합니다.

RpcQosVersion

현재 버전의 값을 전달합니다(이 함수에 대한 확장이 이루어지는 경우 정방향 호환성을 위해 필요함). 항상 이 매개 변수를 RPC_C_SECURITY_QOS_VERSION 설정합니다.

SecurityQOS

서비스 품질 설정을 정의하는 RPC_SECURITY_QOS 구조체에 대한 포인터를 반환합니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_BINDING
 바인딩 핸들이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING
 작업에 대한 잘못된 종류의 바인딩이었습니다.
RPC_BINDING_HAS_NO_AUTH
 바인딩에 인증 정보가 없습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

클라이언트 애플리케이션은 RpcBindingInqAuthInfoEx 함수를 호출하여 서버 바인딩 핸들과 연결된 인증 및 권한 부여 정보를 봅니다. 이 함수는 바인딩 핸들에서 서비스의 보안 품질에 대해 문의하는 기능을 제공합니다. 그렇지 않으면 RpcBindingInqAuthInfo와 동일합니다.

RPC 런타임 라이브러리는 반환된 ServerPrincName 매개 변수에 대한 메모리를 할당합니다. 애플리케이션은 반환된 인수 문자열에 대해 RpcStringFree 함수를 호출합니다.

참고

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

요구 사항

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

추가 정보

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree