다음을 통해 공유

RpcServerInqDefaultPrincName 함수(rpcdce.h)

  • 아티클

RpcServerInqDefaultPrincName 함수는 지정된 인증 서비스의 기본 보안 주체 이름을 가져옵니다.

구문

RPC_STATUS RpcServerInqDefaultPrincName(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

매개 변수

AuthnSvc

서버가 원격 프로시저 호출에 대한 요청을 수신할 때 사용할 인증 서비스입니다.

PrincName

성공하면 AuthnSvc 매개 변수에 지정된 지정된 인증 서비스의 기본 보안 주체 이름을 포함합니다. 사용 중인 인증 서비스는 이름 및 해당 구문의 콘텐츠를 정의합니다. 이 보안 주체 이름은 RpcServerRegisterAuthInfo 함수의 ServerPrincName 매개 변수로 사용해야 합니다. 함수가 성공하면 RpcStringFree 함수를 사용하여 PrincName을 해제해야 합니다. 함수가 실패하면 PrincName 의 내용이 정의되지 않으며 호출자는 함수를 해제할 의무가 없습니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_OUT_OF_MEMORY
 메모리가 부족하여 작업을 완료할 수 없습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

이 함수는 RpcServerRegisterAuthInfo 함수에 전달할 서버 보안 주체 이름을 가져오는 데 권장되는 방법입니다. 이 함수를 사용하지 않고 서버 보안 주체 이름을 작성할 수 있지만, 운영 체제 버전에서 함수를 호출하는 것이 더 쉽고 이식 가능합니다.

요구 사항

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

추가 정보

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo